共用方式為

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

行動寬頻服務傳回的唯一要求識別碼指標，用來識別這個非同步要求。

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK
 作業成功。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
行動寬頻服務未在此系統上執行。
E_HANDLE
 不正確介面。 很可能已從系統移除行動寬頻裝置。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
不正確介面。 很可能已從系統移除行動寬頻裝置。
E_INVALIDARG
 指定了不正確設定檔名稱，或 strProfile 引數不符合 XML 設定檔架構的規範
E_MBN_MAX_ACTI加值稅ED_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