IMbnConnectionEvents：：OnConnectComplete 方法 (mbnapi.h)

重要

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

指示连接操作完成的通知方法。

语法

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

[in] newConnection

一个 IMbnConnection 接口，表示连接操作已完成的设备。

[in] requestID

移动宽带服务分配用于标识连接操作的请求 ID。

[in] status

完成状态。

调用应用程序可能需要以下值之一。

值	含义
S_OK	操作成功。
E_MBN_SIM_NOT_INSERTED	设备中没有 SIM 卡。
E_MBN_PIN_REQUIRED	需要 PIN 才能完成操作。
E_MBN_SERVICE_NOT_ACTIVATED	网络服务订阅已过期。
E_MBN_PROVIDER_NOT_VISIBLE	提供程序不可见。这仅适用于手动注册模式。
E_MBN_INVALID_ACCESS_STRING	连接字符串不正确。
HRESULT_FROM_WIN32 (ERROR_INVALID_PASSWORD)	连接配置文件中使用的名称或密码不正确。
E_MBN_VOICE_CALL_IN_PROGRESS	活动语音呼叫正在进行中。
E_MBN_MAX_ACTIVATED_CONTEXTS	移动宽带上下文已处于活动状态。移动宽带服务当前不支持多个活动上下文。
E_MBN_RADIO_POWER_OFF	设备无线电处于关闭状态。
E_MBN_PACKET_SVC_DETACHED	没有可用的活动附加数据包服务。
E_MBN_ACTIVE_CONNECTION	设备已连接到网络。

此方法必须返回 S_OK。

建立激活上下文后，应用程序可以使用 IMbnConnection 获取当前连接状态。

当连接操作导致错误时，应用程序可以调用 IMbnConnection 接口的 GetActivationNetworkError 方法来获取网络错误信息。