phoneSetButtonInfo  5SKN_I4 

The phoneSetButtonInfo function sets information about the specified button on the specified phone.

LONG phoneSetButtonInfo(

    HPHONE hPhone,

 

    DWORD dwButtonLampID,

 

    LPPHONEBUTTONINFO const lpButtonInfo

 

   );

 

 

Parameters

hPhone

A handle to the open phone device. The application must be the owner of the phone device.

dwButtonLampID

A button on the phone device.

lpButtonInfo

A pointer to a variably sized structure of type PHONEBUTTONINFOLJ8WG_. This data structure describes the mode, the function, and provides additional descriptive text about the button.

 

Return Values

Returns a positive request ID if the function will be completed asynchronously or a negative error number if an error has occurred. The dwParam2 parameter of the corresponding PHONE_REPLYFVXMHG message is zero if the function is successful or it is a negative error number if an error has occurred. Possible return values are:

PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONEHANDLE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.

See Also

PHONE_REPLY, PHONEBUTTONINFO