IMbnConnectionContext：：SetProvisionedContext 方法 (mbnapi.h)

重要

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

新增或更新布建的內容。

語法

HRESULT SetProvisionedContext(
  [in]  MBN_CONTEXT provisionedContexts,
  [in]  LPCWSTR     providerID,
  [out] ULONG       *requestID
);

[in] provisionedContexts

MBN_CONTEXT 結構，指定要儲存在裝置或 SIM 卡中的布建內容。

[in] providerID

字串，表示應該儲存布建內容的網路提供者識別符。當具有此主提供者標識碼的 SIM 卡位於裝置時，裝置應該傳回新增的已布建內容，以回應任何後續查詢。

[out] requestID

行動寬頻服務所設定的要求標識碼，用來識別此異步要求。

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

傳回碼	描述
S_OK	已成功完成命令。
E_HANDLE	無效的介面。最有可能是行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	無效的介面。最有可能是行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	行動寬頻服務未在此系統上執行。
E_INVALID_ARG	providerID 無效。

provisionedContexts 的contextID會指定要儲存內容的裝置或 SIM 記憶體中的索引。如果設定為 MBN_CONTEXT_ID_APPEND，裝置應該會找到適當的索引來儲存內容。

這是異步操作， SetProvisionedContext 會立即傳回。作業完成時，行動寬頻服務會呼叫 IMbnConnectionContextEvents 的 OnSetProvisionedContextComplete 方法來通知應用程式。

在呼叫 IMbnConnectionContextEvents 的 OnProvisionedContextListChange 方法之前，將無法查詢目前主提供者標識符的布建內容清單。