IMbnConnectionProfileManager：：GetConnectionProfile 方法 (mbnapi.h)

重要

從 Windows 10 1803 版開始，本節所述的 Win32 API 會由 Windows.Networking.Connectivity 命名空間中的 Windows 執行階段 API 取代。

取得與指定行動寬頻裝置相關聯的特定連線配置檔。

語法

HRESULT GetConnectionProfile(
  [in]          IMbnInterface         *mbnInterface,
  [in]          LPCWSTR               profileName,
  [out, retval] IMbnConnectionProfile **connectionProfile
);

參數

[in] mbnInterface

IMbnInterface，代表配置檔要求適用的裝置。 如果 mbnInterface 為 NULL，則此函式會傳回與系統中任何裝置相關聯的指定名稱配置檔。

[in] profileName

包含連接配置檔名稱的 Null 終止字串。

[out, retval] connectionProfile

代表所需連線配置檔的 IMbnConnectionProfile 介面。 如果這個方法傳回 S_OK以外的任何專案，則為 NULL。

傳回值

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

傳回碼	描述
S_OK	已成功完成命令。
E_HANDLE	介面無效，最有可能是因為行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	具有指定名稱的配置檔不存在。
HRESULT_FROM_WIN32 (ERROR_NOT_READY)	裝置未就緒。 無法取得訂閱者標識碼，因為裝置未 MBN_READY_STATE_INITIALIZED。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	具有指定名稱的配置檔不存在。

備註

線上配置檔與裝置的訂閱者標識符相關聯。 針對 GSM 裝置，訂閱者標識碼是 SIM 卡的國際行動訂閱者身分識別 (IMSI) 。 針對 CDMA 裝置，它是行動標識碼 (MIN) 字串或國際漫遊 MIN (IRM) 字串串。

如果已使用 CreateConnectionProfile 建立新的配置檔，則呼叫端必須等候 接收 OnConnectionProfileArrival 事件，然後再呼叫具有新配置檔名稱的 GetConnectionProfile ;否則， GetConnectionProfile API 呼叫可能會失敗 ，HRESULT_FROM_WIN32 (ERROR_NOT_FOUND) 。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	都不支援
目標平台	Windows
標頭	mbnapi.h

另請參閱

IMbnConnectionProfileManager