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 以外的任何内容,则不会设置此指针的内容。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
该方法已成功完成。
E_PENDING
调用状态不可用。 移动宽带服务正在探测设备中的信息。 当调用状态可用时,可以通过注册 IMbnConnectionEventsOnVoiceCallStateChange 方法来通知调用应用程序。
E_MBN_PIN_REQUIRED
需要 PIN 才能获取呼叫状态。
E_MBN_SIM_NOT_INSERTED
设备中未插入 SIM 卡。
E_MBN_BAD_SIM
设备中插入了错误的 SIM 卡。

注解

对于 E_MBN_PIN_REQUIREDE_MBN_SIM_NOT_INSERTEDE_MBN_BAD_SIM的可恢复错误,移动宽带服务将在错误条件结束后再次查询设备以获取此信息。 例如,如果设备需要输入 PIN 才能检索语音呼叫状态,则返回 E_MBN_PIN_REQUIRED 。 呼叫应用程序输入 PIN 以解锁设备后,移动宽带服务将再次尝试从设备获取语音呼叫状态。 移动宽带服务将通过调用 IMbnConnectionEventsOnVoiceCallStateChange 方法,使用新探测的状态更新应用程序。

要求

   
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnConnection