IMbnRegistrationEvents::OnSetRegisterModeComplete メソッド (mbnapi.h)

重要

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

モバイル ブロードバンド サービスによって呼び出され、設定された登録操作が完了したことを示す通知メソッド。

構文

HRESULT OnSetRegisterModeComplete(
  [in] IMbnRegistration *newInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

パラメーター

[in] newInterface

該当するデバイスを表す IMbnRegistration インターフェイスへのポインター。 処理アプリケーションでは、このインターフェイスを使用して、デバイスの現在の登録状態を取得できます。

[in] requestID

設定された登録操作を追跡するためにモバイル ブロードバンド サービスによって割り当てられた要求 ID。

[in] status

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

呼び出し元のアプリケーションでは、使用可能な値の 1 つを想定できます。

値	説明
S_OK	操作に成功しました。
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	アクティブなネットワーク接続が既にあります。 登録モードは、既に確立されているデータ接続がある場合は変更できません。 アプリケーションは最初に接続を切断してから、登録モードの変更を試みる必要があります。 デバイスが既に要求モードで、要求されたプロバイダーに接続されている場合は、リターン コードが S_OKされます。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	この操作は、デバイスではサポートされていません。 これは、要求された登録モードをサポートしていないデバイスによって返される場合があります。 たとえば、CDMA デバイスは、手動登録モードに切り替えるよう要求されると、このエラーを返します。
E_FAIL	操作を完了できませんでした。 詳細については、ネットワーク エラー コードを参照してください。
E_INVALIDARG	登録モードの入力が無効であるか、入力が最大長 7 文字を超えるプロバイダー ID、または指定されたデータ クラスが無効です。 入力に無効な引数が指定されている場合、モバイル ブロードバンド サービスはデバイスに要求を送信しません。 手動登録モードでは、要求されたプロバイダーが禁止されていることを示します。
E_MBN_PIN_REQUIRED	操作を完了するには PIN が必要です。
E_MBN_SERVICE_NOT_ACTIVATED	ネットワーク サービス サブスクリプションの有効期限が切れています。
E_MBN_PROVIDER_NOT_VISIBLE	これは、手動登録モードに切り替える場合にのみ発生します。 スイッチは成功しましたが、要求されたプロバイダーは表示されません。 デバイスが表示されると、要求されたプロバイダーに登録されます。

戻り値

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

要件

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

関連項目

IMbnRegistrationEvents