IMbnConnectionCoNtext：：GetProvisionedCoNtexts 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得連接內容的清單。
語法
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
參數
[out, retval] provisionedContexts
MBN_CONTEXT 值的清單 ，表示儲存在裝置中的線上內容。 發生錯誤時，此陣列為 Null。 成功時，呼叫端應用程式必須呼叫 SafeArrayDestroy來釋放已配置的記憶體。
傳回值
這個方法可以傳回其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
線上內容無法使用。 行動寬頻服務正在探查裝置中的資訊。 呼叫端應用程式可以在線上內容可用時收到通知，方法是註冊IMbnConnectionCoNtextEvents的OnProvisionedCoNtextListChange方法。 |
|
需要 PIN 才能取得線上內容。 |
|
SIM 卡不會插入裝置中。 |
|
在裝置中插入不正確的 SIM 卡。 |
|
裝置不支援擷取布建的內容。 |
備註
線上內容是一組特定網路組態參數的抽象概念，用於在第 2 層實體行動寬頻連線上設定虛擬線路或流程。 在 GSM 中，它會對應至 PDP 內容的概念;在 CDMA 中，它會對應至網路設定檔。
在某些情況下，裝置/SIM 記憶體中已有連線參數可用。 這個方法可用來取得儲存在裝置中，供目前家用提供者網路使用的預存線上內容清單。
只有類型 MBN_CONTEXT_TYPE_INTERNET 的內容才應該用於建立資料連線。
裝置會傳回目前主提供者的所有預存內容。 部分內容可以是空的，而且會回報為 MBN_CONTEXT_TYPE_NONE。
有時候，網路可以透過 SMS 或 OTA 來更新儲存的布建內容。 每當裝置布建的內容有所變更時，行動寬頻服務會呼叫IMbnConnectionCoNtextEvents的OnProvisionedCoNtextListChange方法。 然後，應用程式可以使用這個方法來取得已布建內容的更新清單。
針對可復原的錯誤 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM，行動寬頻服務會在錯誤狀況超過時重新查詢裝置，以取得這項資訊。 例如，如果裝置需要輸入 PIN 才能擷取線上內容，則會傳回 E_MBN_PIN_REQUIRED。 當應用程式輸入 PIN 以解除鎖定裝置時，服務會再次嘗試從裝置取得此資訊。 服務會藉由呼叫IMbnConnectionCoNtextEvents的OnProvisionedCoNtextListChange方法，更新有關新查詢狀態的應用程式。
需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |