通过

IMbnConnection：：Connect 方法 (mbnapi.h)

  • 项目

重要

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

建立数据连接。

语法

HRESULT Connect(
  [in]  MBN_CONNECTION_MODE connectionMode,
  [in]  LPCWSTR             strProfile,
  [out] ULONG               *requestID
);

parameters

[in] connectionMode

一个MBN_CONNECTION_MODE值，该值指定连接模式。

[in] strProfile

包含配置文件指示符。

[out] requestID

指向移动宽带服务返回的唯一请求 ID 的指针，用于标识此异步请求。

返回值

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

返回代码 说明
S_OK
 操作成功。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
移动宽带服务未在此系统上运行。
E_HANDLE
 接口无效。 很可能移动宽带设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
接口无效。 很可能移动宽带设备已从系统中删除。
E_INVALIDARG
 指定的配置文件名称无效或 strProfile 参数不符合 XML 配置文件架构
E_MBN_MAX_ACTIVATED_CONTEXTS
 已存在活动的移动宽带上下文。 不支持多个活动上下文。

注解

Connect 方法用于激活设备的连接上下文。 移动宽带服务目前最多支持一个活动上下文。 激活上下文还会导致建立 L2 连接。 同样，停用上下文将导致与移动网络的物理数据连接断开。

如果在调用此操作时设备未处于数据包附加状态，则移动宽带服务将在向设备发出连接请求之前隐式将设备数据包附加。 如果有任何数据包服务状态更改，则通过调用 IMbnRegistrationEvents 接口的 OnPacketServiceStateChange 方法通知应用程序。

如果 connectionMode 设置为 MBN_CONNECTION_MODE_PROFILE，则 strProfile 表示设备的配置文件的名称。 如果设置为 MBN_CONNECTION_MODE_TMP_PROFILE，则 strProfile 表示配置文件的 XML 表示形式。 调用应用程序可以使用 IMbnConnectionProfileManager 获取存储在设备中的连接配置文件的列表。

这是将立即返回的异步操作。 如果此方法成功返回，则移动宽带服务将在操作完成时调用 IMbnConnectionEvents 的 OnConnectComplete 方法。

Windows 8 及更高版本的 Windows：Windows 应用商店应用可能仅将 Connect 与 MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode 和 strProfile 参数一起使用，该参数设置为配置文件的 XML 表示形式。 这意味着连接是临时性的，不会保存供系统将来使用。

要求

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

另请参阅

IMbnConnection