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 |