IMbnInterfaceEvents::OnSetPreferredProvidersComplete 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始,本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
行動寬頻服務會呼叫此通知方法,以指出 SetPreferredProviders 作業完成。
語法
HRESULT OnSetPreferredProvidersComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
參數
[in] newInterface
IMbnInterface,代表執行此作業的裝置。
[in] requestID
行動寬頻服務為此非同步作業指派的要求識別碼。
[in] status
作業完成狀態。
下表列出此狀態的有效值。
值 | 意義 |
---|---|
|
作業成功。 |
|
裝置需要輸入 PIN 才能完成此作業。 |
|
不會插入 SIM 卡。 |
|
在裝置中插入不正確的 SIM 卡。 |
|
裝置不支援這項作業。 |
傳回值
這個方法必須傳回 S_OK。
備註
如果作業順利完成,也就是當狀態S_OK時,應用程式可以呼叫傳遞IMbnInterface的GetPreferredProviders方法,以取得慣用提供者的更新清單。
如果有多個應用程式已註冊通知,則會在所有已註冊的應用程式上呼叫此方法。 這表示未起始更新作業的應用程式也會收到通知。
如果呼叫IMbnInterface的SetPreferredProviders方法會導致慣用提供者清單中的變更,則不會呼叫IMbnInterfaceEvents的OnPreferredProvidersChange方法。
需求
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | mbnapi.h |