phoneGetStatusMessages 函数 (tapi.h)

phoneGetStatusMessages 函数返回指定电话设备上的哪些手机状态更改会生成应用程序的回调。

语法

LONG phoneGetStatusMessages(
  HPHONE  hPhone,
  LPDWORD lpdwPhoneStates,
  LPDWORD lpdwButtonModes,
  LPDWORD lpdwButtonStates
);

hPhone

要监视的打开电话设备的句柄。

lpdwPhoneStates

指向包含零个、一个或多个PHONESTATE_常量的DWORD 的指针。这些标志指定应用程序可以接收通知消息的电话状态更改和事件集。可以单独启用和禁用监视。

lpdwButtonModes

指向 DWORD 的指针，其中包含指定应用程序可以接收通知消息的电话按钮模式集的标志。此参数使用零个、一个或多个 PHONEBUTTONMODE_常量。

lpdwButtonStates

指向 DWORD 的指针，该 DWORD 包含指定应用程序可以接收通知消息的电话按钮状态更改集的标志。此参数使用零个、一个或多个 PHONEBUTTONSTATE_常量。

如果请求成功，则返回零;如果发生错误，则返回负错误号。可能的返回值为：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_OPERATIONFAILED、PHONEERR_UNINITIALIZED。

应用程序可以使用 phoneGetStatusMessages 查询相应消息的生成。消息生成可由 phoneGetStatusMessages 控制。默认情况下禁用所有手机状态消息。