IMbnInterface：：GetReadyState 方法 (mbnapi.h)

  • 项目

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。

获取就绪状态。

语法

HRESULT GetReadyState(
  [out, retval] MBN_READY_STATE *readyState
);

parameters

[out, retval] readyState

指向 MBN_READY_STATE 结构的指针。 如果此方法返回 除 S_OK 以外的任何值，则此参数为 NULL。

返回值

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

返回代码 说明
S_OK
 该方法已成功完成。 readyState 包含有效值。
E_PENDING
 该信息不可用。 移动宽带服务当前正在探测就绪状态。 通过注册 IMbnInterfaceEvents 的 OnReadyStateChange 方法，当就绪状态可用时，调用应用程序可以收到通知。

注解

就绪状态指定接口是否已成功初始化并准备好执行连接操作。 对于基于 SIM 卡的设备，当设备成功初始化 SIM 时，设备已准备就绪。 仅当就绪状态为 MBN_READY_STATE_INITIALIZED时，设备才可用于连接。 有关其他设备状态的详细信息，请参阅 MBN_READY_STATE。

接口的就绪状态可能会因用户操作而更改。 例如，当用户将 SIM 卡插入设备时，就绪状态将从 MBN_READY_STATE_SIM_NOT_INSERTED 更改为另一个就绪状态。 由于应用程序执行的其他操作，就绪状态也可能更改。 例如，输入 PIN 后，就绪状态可以从 MBN_READY_STATE_DEVICE_LOCKED 更改为另一个就绪状态。 每当接口的就绪状态发生更改时，应用程序都可以注册事件通知。 调用 IMbnInterfaceEvents 的 OnReadyStateChange 成员，以通知应用程序处于就绪状态的任何更改。

当设备的短信子系统报告 MBN_READY_STATE_INITIALIZED时，它可能尚未准备就绪。 调用应用程序应等待对 IMbnSmsEvents 的 OnSmsConfigurationChange 成员的调用，指示 SMS 子系统已准备就绪。

要求

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

另请参阅

IMbnInterface