OID_WWAN_PIN
OID_WWAN_PIN は、個人識別番号 (PIN) に関連する情報を設定または返します。
ミニポート ドライバーは、set 要求と query 要求を非同期的に処理する必要があります。最初は元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後でset 要求または query 要求が完了したときにNDIS_STATUS_WWAN_PIN_INFO状態通知を送信します。
ミニポート ドライバーは、NDIS_WWAN_PIN_INFO構造体を含むNDIS_STATUS_WWAN_PIN_INFO状態通知を送信して PIN の種類と PIN エントリの状態情報を返す必要があります。主に、クエリ要求を完了するときに、MB デバイスまたは加入者識別モジュール (SIM カード) のロックを解除するために PIN が必要かどうかを示します。
PIN に関連する情報の set 要求を行う呼び出し元は、ミニポート ドライバーにNDIS_WWAN_SET_PIN構造を提供することで、MB デバイスへの PIN の送信、PIN の設定の有効化または無効化、SIM の PIN の変更を行います。
解説
この OID の使用の詳細については、WWAN Pin 操作を参照してください。
Windows 7 ミニポート ドライバーは、OID_WWAN_PIN を使用する必要があります。 Windows 8 ミニポート ドライバーは、OID_WWAN_PIN_EXを使用する必要があります。
query 操作を処理する場合、ミニポート ドライバーは加入者識別モジュール (SIM カード) にアクセスできますが、プロバイダー ネットワークにはアクセスできません。
有効になっている場合、MB サービスはミニポート ドライバーの初期化プロセス中に PIN1 が正常にロック解除されるまで登録を続行しません。
ミニポートドライバは、set 要求を処理するときに、NDIS_WWAN_SET_PIN 構造体のPinAction.Pinメンバに、エンドユーザが入力したPIN値を提供します。 PIN 値が SIM カードに格納されている値と一致する場合にのみ、ミニポート ドライバーによって要求が処理されます。 それ以外の場合、ミニポート ドライバーは、状態コード WWAN_STATUS_FAILURE でセット要求を失敗させます。
CDMA ベースのデバイスは、電源投入時の デバイス ロックを PIN1 として報告する必要があります。
サポートされているすべての PIN の種類について、ミニポート ドライバーはWwanPinOperationEnter操作をサポートしている必要があります。 さらに、PIN1 がサポートされている場合、ミニポート ドライバーは、WwanPinOperationEnable、WwanPinOperationDisable、およびWwanPinOperationChange操作をサポートしている必要があります。
ロックされている PIN の種類に対して PIN 無効化操作が試行された場合、ミニポート ドライバーは、WWAN_STATUS_PIN_REQUIRED で要求を失敗させるか、要求を正常に完了することができます。 ミニポート ドライバーが要求を正常に完了した場合、無効化操作によって PIN もロック解除されます。
複数の PIN のレポートが有効になっているが、一度に 1 つの PIN しか報告できない場合、ミニポート ドライバーは最初に PIN1 を報告することが期待されます。 例えば、SubsidyLock と SIM PIN1 の報告が有効になっている場合、PIN1 が正常に検証された後にのみ、(後続の query 要求で) SubsidyLock PIN を報告する必要があります。
MB API は、PIN1 以外の PIN もサポートしています。 ただし、Windows 接続マネージャー/GUI では PIN1 のみがサポートされるため、サード パーティ製の接続マネージャー/GUI をインストールする必要があります。
要件
バージョン |
Windows 7 以降のバージョンの Windows で使用できます。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |