IMbnPinManager::GetPinState メソッド (mbnapi.h)

重要

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

デバイスの現在の PIN 状態を取得します。

構文

HRESULT GetPinState(
  [out] ULONG *requestID
);

パラメーター

[out] requestID

この非同期要求に対してモバイル ブロードバンド サービスによって設定された要求 ID へのポインター。 応答には、同じ要求 ID が含まれます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE	モバイル ブロードバンド デバイスがシステムから削除されているため、インターフェイスは無効です。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されています。

解説

GetPinState メソッドは、デバイスの PIN 状態に対する非同期要求を開始します。 PIN 状態は、要求された操作を完了するために PIN を入力する必要があるかどうかを示します。 また、デバイスで予想される PIN の種類に関する情報も含まれており、必要に応じて、有効な PIN を入力するための残りの試行回数を提供します。

このメソッドは、常にデバイスの現在の PIN 状態を返します。 このオブジェクトが作成された時点では、PIN 状態はキャッシュされません。 代わりに、常にデバイスに接続し、デバイスの現在の PIN 状態を返します。

これは非同期操作であるため、 GetPinState はすぐに返されます。 操作が完了すると、モバイル ブロードバンド サービスは IMbnPinManagerEvents の OnGetPinStateComplete メソッドを呼び出します。

操作が E_MBN_PIN_REQUIRED を返すか、デバイスによって報告された準備完了状態が MBN_READY_STATE_DEVICE_LOCKEDされるたびに、アプリケーションはこのメソッドを使用して、デバイスまたは SIM のロック解除に必要な PIN の種類を照会する必要があります。

この操作の進行中に、モバイル ブロードバンド デバイスがシステムから削除された場合、IMbnPinManagerEvents の OnGetPinStateComplete メソッドの呼び出しは保証されません。

要件

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

関連項目

IMbnPinManager