IMbnConnectionProfileManager：：GetConnectionProfiles 方法 (mbnapi.h)

重要

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

取得與裝置相關聯的連線配置檔案清單。

語法

HRESULT GetConnectionProfiles(
  [in]          IMbnInterface *mbnInterface,
  [out, retval] SAFEARRAY     **connectionProfiles
);

[in] mbnInterface

IMbnInterface，代表設定檔要求適用的裝置。如果這是 Null，函式會傳回系統中所有存在的設定檔。

[out, retval] connectionProfiles

IMbnConnectionProfile介面的陣列，代表裝置的所有可用連線設定檔。如果這個方法傳回 S_OK以外的任何專案，則陣列指標為 Null，否則呼叫的應用程式最終必須呼叫 SafeArrayDestroy來釋放配置的記憶體。

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

傳回碼	描述
S_OK	已成功完成命令。
E_HANDLE	介面無效，最有可能是因為行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_READY)	裝置未就緒。無法取得訂閱者識別碼，因為裝置未 MBN_READY_STATE_INITIALIZED。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	行動寬頻服務未在此系統上執行。

針對特定裝置呼叫此作業時，它會傳回配置檔案清單，其具有與裝置目前報告相同的訂閱者識別碼。 IMbnInterface的GetSubscriberInformation方法可用來取得與介面相關聯的訂閱者識別碼。

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