phoneSetButtonInfo 函式 (tapi.h)

phoneSetButtonInfo函式會設定指定手機上指定按鈕的相關資訊。

語法

LONG phoneSetButtonInfo(
  HPHONE                  hPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

參數

hPhone

開啟手機裝置的控制碼。 應用程式必須是手機裝置的擁有者。

dwButtonLampID

手機裝置上的按鈕。

lpButtonInfo

PHONEBUTTONINFO類型的可變大小結構指標。 此資料結構描述模式、函式，並提供按鈕的其他描述性文字。

傳回值

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

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

規格需求

另請參閱

PHONEBUTTONINFO

PHONE_REPLY

補充電話語音函式

TAPI 2.2 參考概觀