IMbnInterfaceEvents::OnSetPreferredProvidersComplete メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。

この通知メソッドは、 SetPreferredProviders 操作の完了を示すために、モバイルブロードバンドサービスによって呼び出されます。

構文

HRESULT OnSetPreferredProvidersComplete(
  [in] IMbnInterface *newInterface,
  [in] ULONG         requestID,
  [in] HRESULT       status
);

[in] newInterface

この操作が実行されたデバイスを表す IMbnInterface 。

[in] requestID

この非同期操作に対してモバイルブロードバンドサービスによって割り当てられた要求 ID。

[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場合、アプリケーションは、渡された IMbnInterface の GetPreferredProviders メソッドを呼び出して、優先プロバイダーの更新された一覧を取得できます。

通知に複数のアプリケーションが登録されている場合は、登録されているすべてのアプリケーションでこのメソッドが呼び出されます。つまり、更新操作を開始しなかったアプリケーションも通知を受け取ります。

IMbnInterface の SetPreferredProviders メソッドを呼び出すと、優先プロバイダーリストが変更された場合、IMbnInterfaceEvents の OnPreferredProvidersChange メソッドは呼び出されません。