IMbnConnection::GetVoiceCallState 方法 (mbnapi.h)
重要
从 Windows 10 版本 1803 开始,本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的 Windows 运行时 API。
获取设备的语音呼叫状态。
语法
HRESULT GetVoiceCallState(
[out, retval] MBN_VOICE_CALL_STATE *voiceCallState
);
parameters
[out, retval] voiceCallState
指向 MBN_VOICE_CALL_STATE 值的指针,该值指定语音呼叫状态。 如果方法返回 除 S_OK 以外的任何内容,则不会设置此指针的内容。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
该方法已成功完成。 |
|
调用状态不可用。 移动宽带服务正在探测设备中的信息。 当调用状态可用时,可以通过注册 IMbnConnectionEvents 的 OnVoiceCallStateChange 方法来通知调用应用程序。 |
|
需要 PIN 才能获取呼叫状态。 |
|
设备中未插入 SIM 卡。 |
|
设备中插入了错误的 SIM 卡。 |
注解
对于 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM的可恢复错误,移动宽带服务将在错误条件结束后再次查询设备以获取此信息。 例如,如果设备需要输入 PIN 才能检索语音呼叫状态,则返回 E_MBN_PIN_REQUIRED 。 呼叫应用程序输入 PIN 以解锁设备后,移动宽带服务将再次尝试从设备获取语音呼叫状态。 移动宽带服务将通过调用 IMbnConnectionEvents 的 OnVoiceCallStateChange 方法,使用新探测的状态更新应用程序。
要求
最低受支持的客户端 | Windows 7 [桌面应用 |UWP 应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | mbnapi.h |