phoneGetStatus 函数 (tapi.h)
phoneGetStatus 函数使应用程序能够查询指定的打开电话设备的总体状态。
语法
LONG phoneGetStatus(
HPHONE hPhone,
LPPHONESTATUS lpPhoneStatus
);
参数
hPhone
要查询的打开电话设备的句柄。
lpPhoneStatus
指向 PHONESTATUS 类型的可变大小数据结构的指针,该结构与有关手机状态的返回信息一起加载。
返回值
如果请求成功,则返回零;如果发生错误,则返回负错误号。 可能的返回值为:
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_OPERATIONFAILED、PHONEERR_STRUCTURETOOSMALL、PHONEERR_OPERATIONUNAVAIL PHONEERR_UNINITIALIZED。
注解
应用程序可以使用此函数来确定打开的手机设备的当前状态。 状态信息描述有关手机设备的挂钩开关设备、铃声、音量、显示器和灯的信息。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | tapi.h |
Library | Tapi32.lib |
DLL | Tapi32.dll |