IMbnConnection：：GetConnectionState 方法 (mbnapi.h)

重要

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

获取设备的当前连接状态。

语法

HRESULT GetConnectionState(
  [out, retval] MBN_ACTIVATION_STATE *ConnectionState,
  [out, retval] BSTR                 *ProfileName
);

[out, retval] ConnectionState

指向包含连接状态的MBN_ACTIVATION_STATE 结构的指针。

[out, retval] ProfileName

指向包含连接配置文件名称的字符串的指针。此参数仅在MBN_ACTIVATION_STATE_ACTIVATEDConnectionState 时才有效。如果此字符串不为 NULL，则调用应用程序必须通过调用 SysFreeString 释放此字符串。

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

返回代码	说明
S_OK	该方法已成功完成。注意当 ProfileName 为 NULL 时，此方法可以返回S_OK。确保客户端能够处理 NULLProfileName ，即使调用成功。
E_PENDING	激活状态不可用。移动宽带服务正在探测设备以获取信息。可以通过注册 IMbnConnectionEvents 的 OnConnectStateChange 方法，在激活状态可用时通知调用应用程序。
E_MBN_PIN_REQUIRED	需要 PIN 才能获取呼叫状态。
E_MBN_SIM_NOT_INSERTED	不会在设备中插入 SIM 卡。
E_MBN_BAD_SIM	设备中插入了错误的 SIM 卡。

当 ProfileName 为 NULL 时，此方法可以返回S_OK。确保客户端能够处理 NULLProfileName ，即使调用成功。