共用方式為

IMbnConnectionContextEvents：：OnSetProvisionedContextComplete 方法 (mbnapi.h)

  • 發行項

重要

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

行動寬頻服務所呼叫的通知方法，指出裝置中已設定布建的內容。

語法

HRESULT OnSetProvisionedContextComplete(
  [in] IMbnConnectionContext *newInterface,
  [in] ULONG                 requestID,
  [in] HRESULT               status
);

參數

[in] newInterface

IMbnConnectionContext 介面，代表已設定內容的裝置。

[in] requestID

行動寬頻服務所設定的要求標識碼，用來識別設定內容的作業。

[in] status

表示作業結果的狀態代碼。

呼叫的應用程式可以預期下列其中一個值。

值 意義
S_OK
 作業成功。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
裝置不支援這項作業。
E_MBN_PIN_REQUIRED
 作業需要 PIN 才能完成。
E_INVALIDARG
 要求中提供的內容識別碼或提供者標識碼無效。
E_MBN_BAD_SIM
 裝置中有不正確的 SIM 卡。
HRESULT_FROM_WIN32 (ERROR_WRITE_FAULT)
SIM 卡或裝置記憶體中的更新失敗。

傳回值

這個方法必須傳回 S_OK。

備註

呼叫的應用程式可以將 IMbnConnectionContext 介面傳遞至 newInterface ，以取得裝置中已佈建內容的更新清單。 不過，由於此作業是異步的，因此應用程式必須先等候 OnProvisionedContextListChange 通知，才能使用此介面來取得內容。

如果已註冊多個應用程式來接收通知，則即使只有其中一個應用程式可以起始這項作業，所有應用程式仍會收到此通知。

規格需求

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

另請參閱

IMbnConnectionContextEvents