IMbnPinManagerEvents::OnGetPinStateComplete メソッド (mbnapi.h)

  • [アーティクル]

重要

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

IMbnPinManager の GetPinState メソッドの呼び出しによってトリガーされる非同期操作の完了を示すために、モバイル ブロードバンド サービスによって呼び出される通知メソッド。

構文

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

パラメーター

[in] pinManager

操作が実行されたモバイル ブロードバンド デバイスを表す IMbnPinManager インターフェイスへのポインター。

[in] pinInfo

デバイス PIN 情報を含む MBN_PIN_INFO 構造体。

pinInfo.pinState が MBN_PIN_STATE_NONE に設定されている場合、デバイスによって PIN が入力されることは想定されていません。

pinInfo.pinState が MBN_PIN_STATE_ENTER に設定されている場合、デバイスは PIN の入力を想定しており、pinInfo.pinType はデバイスで想定される PIN の種類を表します。

pinInfo.pinState が MBN_PIN_STATE_UNBLOCK に設定されている場合、デバイスは PIN ブロックされ、PIN のブロック解除操作を試してデバイスのブロックを解除する必要があります。 この場合、 pinInfo.pinType は、ブロック解除操作を実行する必要がある PIN の種類を表します。

pinInfo.pinState が MBN_PIN_STATE_ENTER または MBN_PIN_STATE_UNBLOCK に設定されている場合、pinInfo.attemptsRemaining には、有効な PIN または PIN ブロック解除キー (PUK) を入力するための残りの試行回数が含まれます。 残りの試行回数が不明な場合、 pinInfo.attemptsRemaining は MBN_ATTEMPTS_REMAINING_UNKNOWN に設定されます。

[in] requestID

この操作を識別するためにモバイル ブロードバンド サービスによって割り当てられた要求 ID。

[in] status

操作の完了状態。

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

値 説明
S_OK
 操作に成功しました。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 デバイスは PIN 操作をサポートしていません。
E_MBN_SIM_NOT_INSERTED
 SIM がデバイスにないため、操作を完了できませんでした。
E_MBN_BAD_SIM
 デバイスで無効な SIM が検出されたため、操作を完了できませんでした。

戻り値

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

解説

このメソッドは、IMbnPinManager の GetPinState メソッドの呼び出しによってトリガーされる非同期操作の完了をアプリケーションに通知するために、モバイル ブロードバンド サービスによって呼び出されます。
正常に完了すると、 pinInfo には、デバイスで次に想定される PIN に関する情報が含まれます。

要件

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

関連項目

IMbnPinManagerEvents