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
);

参数

[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