IMbnMultiCarrierEvents::OnSetHomeProviderComplete メソッド (mbnapi.h)

重要

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

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

構文

HRESULT OnSetHomeProviderComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

[in] mbnInterface

モバイルブロードバンドデバイスの SetHomeProvider 操作を表す IMbnMultiCarrier オブジェクト。

[in] requestID

モバイルブロードバンドサービスによって SetHomeProvider 操作に割り当てられた要求 ID。

[in] status

SetHomeProvider の結果を示す状態コード。

値	意味
S_OK	操作に成功しました。
E_MBN_PROVIDER_NOT_VISIBLE	要求されたプロバイダーは表示されません。
E_INVALIDARG	登録モードの入力が無効です。入力として指定されたプロバイダー ID が最大長 7 文字を超えているか、指定されたデータクラスが無効です。入力に無効な引数が指定されている場合、モバイルブロードバンドサービスはデバイスに要求を送信しません。手動登録モードでは、要求されたプロバイダーが禁止されていることを示します。
E_FAIL	操作を完了できませんでした。詳細については、ネットワークエラーコードを参照してください。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	この操作は、デバイスではサポートされていません。これは、マルチキャリアをサポートしていないデバイスによって返される場合があります。

このメソッドは 、S_OKを返す必要があります。

status がS_OK場合、インターフェイスのホームプロバイダーは SetHomeProvider によって新しいプロバイダーに正常に設定されています。それ以外の場合、元のホームプロバイダーは変更されず、インターフェイスの接続、パケットサービスなど、以前の状態は変更されません。