共用方式為


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

作業完成狀態。

下表列出此狀態的有效值。

意義
S_OK
作業成功。
E_MBN_PIN_REQUIRED
裝置需要輸入 PIN 才能完成此作業。
E_MBN_SIM_NOT_INSERTED
不會插入 SIM 卡。
E_MBN_BAD_SIM
在裝置中插入不正確的 SIM 卡。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
裝置不支援這項作業。

傳回值

這個方法必須傳回 S_OK

備註

如果作業順利完成,也就是當狀態S_OK時,應用程式可以呼叫傳遞IMbnInterfaceGetPreferredProviders方法,以取得慣用提供者的更新清單。

如果有多個應用程式已註冊通知,則會在所有已註冊的應用程式上呼叫此方法。 這表示未起始更新作業的應用程式也會收到通知。

如果呼叫IMbnInterfaceSetPreferredProviders方法會導致慣用提供者清單中的變更,則不會呼叫IMbnInterfaceEventsOnPreferredProvidersChange方法。

需求

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

另請參閱

IMbnInterfaceEvents