Edit

phoneGetButtonInfo function (tapi.h)

  • Article

The phoneGetButtonInfo function returns information about the specified button.

Syntax

LONG phoneGetButtonInfo(
  HPHONE            hPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

Parameters

hPhone

Handle to the open phone device.

dwButtonLampID

Button on the phone device.

lpButtonInfo

Pointer to a variably sized structure of type PHONEBUTTONINFO. This data structure describes the mode and the function, and provides additional descriptive text corresponding to the button.

Return value

Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are:

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

Requirements

Requirement Value
Target Platform Windows
Header tapi.h
Library Tapi32.lib
DLL Tapi32.dll

See also

PHONEBUTTONINFO

Supplementary Phone Service Functions

TAPI 2.2 Reference Overview