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。

要求

目标平台	Windows
标头	tapi.h
Library	Tapi32.lib
DLL	Tapi32.dll

另请参阅

PHONEBUTTONINFO

PHONE_REPLY

补充电话服务函数

TAPI 2.2 参考概述