Share via

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

  • [アーティクル]

重要

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

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

構文

HRESULT OnUnblockComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

パラメーター

[in] Pin

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

[in] pinInfo

失敗 操作の場合 に残りの試行に関する情報を含むMBN_PIN_INFO構造体へのポインター。 pinInfo の内容は、状態が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 があります。

戻り値

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

解説

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

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

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

デバイスのブロック解除に失敗し、PUK ブロックが MBN_PIN_TYPE_PIN1 ピンの場合は、デバイスの準備完了状態も MBN_READY_STATE_BAD_SIMに変わります。 呼び出し元のアプリケーションは、IMbnInterfaceEvents の OnReadyStateChange メンバーを介して ReadyState の変更について通知されます。

要件

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

関連項目

IMbnPinEvents