phoneSetStatusMessages 函数 (tapi.h)

  • 项目

phoneSetStatusMessages 函数使应用程序能够监视指定电话设备的所选状态事件。

语法

LONG phoneSetStatusMessages(
  HPHONE hPhone,
  DWORD  dwPhoneStates,
  DWORD  dwButtonModes,
  DWORD  dwButtonStates
);

参数

hPhone

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

dwPhoneStates

应用程序可以接收通知消息的手机状态更改和事件集。 此参数可以具有零个、一个或多个 PHONESTATE_常量。

dwButtonModes

应用程序可以接收通知消息的电话按钮模式集。 此参数可以具有零个、一个或多个 PHONEBUTTONMODE_常量。

dwButtonStates

应用程序可以接收通知消息的电话按钮状态更改集。 如果 dwButtonModes 参数为零，则忽略 dwButtonStates 。 如果 dwButtonModes 设置了一个或多个位，则此参数还必须至少设置一个位。 此参数使用 常量PHONEBUTTONSTATE_。

返回值

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

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPHONESTATE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALBUTTONMODE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALBUTTONSTATE、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。

注解

应用程序可以使用 phoneSetStatusMessages 函数启用或禁用相应消息的生成。 默认情况下禁用所有手机状态消息。

要求

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

另请参阅

PHONECAPS

PHONE_CLOSE

PHONE_STATE

补充电话服务函数

TAPI 2.2 参考概述

phoneGetDevCaps

phoneInitialize

phoneInitializeEx

phoneOpen