phoneSetLamp 函式 (tapi.h)

phoneSetLamp 函式會使指定的燈光在指定的開啟手機裝置上以指定的燈光模式亮起。

語法

LONG phoneSetLamp(
  HPHONE hPhone,
  DWORD  dwButtonLampID,
  DWORD  dwLampMode
);

參數

hPhone

開啟手機裝置的句柄。 應用程式必須是手機的擁有者。

dwButtonLampID

要燈亮的按鈕。

dwLampMode

燈光如何亮起。 此參數只會使用其中一個 PHONELAMPMODE_常數。

傳回值

如果函式是以異步方式完成，則傳回正要求標識碼，如果發生錯誤，則傳回負錯誤號碼。 如果函式成功，則對應PHONE_REPLY訊息的 dwParam2 參數為零，如果發生錯誤，則為負錯誤號碼。 可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_OPERATIONUNAVAIL、PHONEERR_NOTOWNER、PHONEERR_NOMEM、PHONEERR_INVALBUTTONLAMPID、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALPHONESTATE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALLAMPMODE PHONEERR_UNINITIALIZED。

規格需求

另請參閱

PHONE_REPLY

補充電話服務功能

TAPI 2.2 參考概觀