IMbnMultiCarrier::SetHomeProvider メソッド (mbnapi.h)

重要

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

マルチキャリア デバイスのホーム プロバイダーを更新します。

構文

HRESULT SetHomeProvider(
  [in]  MBN_PROVIDER2 *homeProvider,
  [out] ULONG         *requestID
);

パラメーター

[in] homeProvider

ホーム プロバイダーを含む MBN_PROVIDER2 構造体。

注  

SignalStrength メンバーと SignalError メンバーは 0 である必要があります。

 

[out] requestID

この要求のオペレーティング システムによって設定された要求 ID へのポインター。 OnSetHomeProviderComplete からの非同期応答には、これと同じ requestID が含まれます。

この要求のオペレーティング システムによって設定された要求 ID へのポインター。 非同期応答には、この同じ requestID が含まれます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE	インターフェイスが無効です。 モバイル ブロードバンド デバイスは、おそらくシステムから削除されています。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されています。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	この操作は、デバイスではサポートされていません。 これは、マルチキャリアをサポートしていないデバイスによって返される場合があります。

解説

SetHomeProvider メソッドは、インターフェイスのホーム プロバイダーの更新を開始します。 これは非同期操作であり、メソッド呼び出しはすぐにを返します。 このメソッドが S_OK で正常に返された場合、Windows は IMbnMultiCarrierEvents の OnSetHomeProviderComplete メソッドを呼び出すことによって、この操作の完了状態について呼び出し元アプリケーションに通知します。

その後、デバイスは自動的に新しいネットワークに登録され、登録状態の変更を示します。 SetHomeProvider を再び使用して新しいホーム プロバイダーを設定しない限り、デバイスは Windows の再起動後もこの新しいホーム ネットワークに登録され続けます。

この操作が完了する前にデバイスがシステムから削除された場合、呼び出し元のアプリケーションによって完了通知が受信される保証はありません。

要件

サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mbnapi.h

関連項目

IMbnMultiCarrier