phoneGetButtonInfo 函式 (tapi.h)

phoneGetButtonInfo 函式會傳回指定按鈕的相關信息。

語法

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

參數

hPhone

開啟手機裝置的句柄。

dwButtonLampID

手機裝置上的按鈕。

lpButtonInfo

PHONEBUTTONINFO 類型的可變大小結構指標。 此數據結構描述模式和函式，並提供對應至按鈕的其他描述性文字。

傳回值

如果要求成功，則傳回零，如果發生錯誤，則傳回負錯誤號碼。 可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALBUTTONLAMPID、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPOINTER、PHONEERR_OPERATIONFAILED、PHONEERR_INVALPHONESTATE、PHONEERR_STRUCTURETOOSMALL、PHONEERR_OPERATIONUNAVAIL PHONEERR_UNINITIALIZED。

規格需求

另請參閱

PHONEBUTTONINFO

補充電話服務功能

TAPI 2.2 參考概觀