IMbnPinEvents::OnEnableComplete メソッド (mbnapi.h)

  • [アーティクル]

重要

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

PIN の有効化操作が完了したことを示すために、モバイル ブロードバンド サービスによって呼び出される通知メソッド。

構文

HRESULT OnEnableComplete(
  [in] IMbnPin      *pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

パラメーター

[in] pin

PIN の種類を表す IMbnPin インターフェイス。

[in] pinInfo

失敗 操作の場合 に残りの試行に関する情報を含むMBN_PIN_INFO構造体へのポインター。 pinInfo の内容は、status がE_MBN_FAILUREされている場合にのみ意味があります。

[in] requestID

PIN の有効化要求を識別するためにモバイル ブロードバンド サービスによって設定された要求 ID。

[in] status

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

呼び出し元のアプリケーションでは、次のいずれかの値が必要です。

値 説明
S_OK
 操作に成功しました。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 デバイスはこの操作をサポートしていません。
E_FAIL
 操作を完了できませんでした。
E_MBN_PIN_REQUIRED
 操作を完了するには PIN が必要です。 呼び出し元のアプリケーションは、IMbnPinManager の GetPinState メソッドを呼び出して、予想される PIN の種類を検出できます。
E_MBN_SIM_NOT_INSERTED
 デバイスに SIM はありません。
E_MBN_BAD_SIM
 デバイスに不適切な SIM があります。
E_MBN_FAILURE
 PIN の使用に失敗しました。

戻り値

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

解説

OnEnableComplete メソッドは、IMbnPin の Enable メソッドの呼び出しによって初期化された PIN 有効化操作の完了状態を報告するために、モバイル ブロードバンド サービスによって呼び出されます。

pinInfo の内容は、status がE_MBN_FAILUREされている場合にのみ意味があります。 pinState メンバーは無視し、pinType フィールドは現在の IMbnPin インターフェイスの PIN 型に設定する必要があります。 この構造体には、有効な PIN を入力するための残りの試行が含まれています。

たとえば、PIN の種類を変更するために渡された PIN が正しくない場合、操作は E_MBN_FAILUREの状態コードで失敗します。 この場合、 pinInfo.attemptsRemaining は、この操作を再試行するための残りの試行回数を指定します。 間違った PIN で繰り返し試行すると、attemptsRemaining が 0 になる場合、アプリケーションは IMbnPinManager の GetPinState メソッドを呼び出して、必要な PIN の種類を取得できます。

要件

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

関連項目

IMbnPinEvents