IMbnConnection：：Connect 方法 (mbnapi.h)

建立数据连接。

语法

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

parameters

[in] connectionMode

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

[in] strProfile

包含配置文件指示符。

[out] requestID

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

返回值

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

注解

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 表示形式。 这意味着连接是临时性的，不会保存供系统将来使用。

要求

另请参阅

IMbnConnection