OID_WWAN_PIN
OID_WWAN_PIN legt Informationen im Zusammenhang mit persönlichen Identifikationsnummern (Personal Identification Numbers, PINs) fest oder gibt diese zurück.
Miniport-Treiber müssen Set- und Abfrageanforderungen asynchron verarbeiten und zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_PIN_INFO status Benachrichtigung senden, wenn sie den Satz oder die Abfrageanforderung abgeschlossen haben.
Miniport-Treiber sollten NDIS_STATUS_WWAN_PIN_INFO status-Benachrichtigungen senden, die eine NDIS_WWAN_PIN_INFO-Struktur enthalten, um PIN-Typ- und PIN-Eintragsstatusinformationen zurückzugeben, in erster Linie, um anzugeben, ob eine PIN erforderlich ist, um das MB-Gerät oder das Abonnentenidentitätsmodul (SIM-Karte) beim Abschließen von Abfrageanforderungen zu entsperren.
Anrufer, die Informationen im Zusammenhang mit PINs festlegen möchten, stellen dem Miniporttreiber eine NDIS_WWAN_SET_PIN Struktur bereit, um eine PIN an das MB-Gerät zu senden, PIN-Einstellungen zu aktivieren oder zu deaktivieren oder eine PIN auf der SIM-Karte zu ändern.
Bemerkungen
Weitere Informationen zur Verwendung dieser OID finden Sie unter WWAN-Pinvorgänge .
Windows 7-Miniporttreiber sollten OID_WWAN_PIN verwenden. Windows 8 Miniporttreiber sollten OID_WWAN_PIN_EX verwenden.
Miniport-Treiber können beim Verarbeiten von Abfragevorgängen auf das Subscriber Identity Module (SIM Karte) zugreifen, sollten jedoch nicht auf das Anbieternetzwerk zugreifen.
Während der Initialisierung des Miniporttreibers fährt der MB-Dienst erst dann mit der Registrierung fort, wenn PIN1 erfolgreich entsperrt wurde( sofern aktiviert).
Miniport-Treiber stellen einen PIN-Wert bereit, der vom Endbenutzer im PinAction.Pin-Element der NDIS_WWAN_SET_PIN-Struktur eingegeben wird, wenn Setanforderungen verarbeitet werden. Nur wenn der PIN-Wert mit dem im SIM-Karte gespeicherten Wert übereinstimmt, sollte die Anforderung vom Miniporttreiber verarbeitet werden. Andernfalls sollten Miniporttreiber die set-Anforderung mit status Code WWAN_STATUS_FAILURE fehlschlagen.
CDMA-basierte Geräte müssen die Einschaltgerätesperre als PIN1 melden.
Für alle unterstützten PIN-Typen müssen Miniporttreiber den WwanPinOperationEnter-Vorgang unterstützen. Wenn PIN1 unterstützt wird, müssen Miniporttreiber außerdem die Vorgänge WwanPinOperationEnable, WwanPinOperationDisable und WwanPinOperationChange unterstützen.
Wenn ein PIN-Deaktivierungsvorgang für einen PIN-Typ versucht wird, wenn dieser PIN-Typ gesperrt ist, können Miniporttreiber die Anforderung entweder mit WWAN_STATUS_PIN_REQUIRED fehlschlagen oder die Anforderung erfolgreich abschließen. Wenn der Miniporttreiber die Anforderung erfolgreich abgeschlossen hat, sollte der Deaktivierungsvorgang auch die PIN entsperren.
Wenn die Meldung mehrerer PINs aktiviert ist und nur eine PIN gleichzeitig gemeldet werden kann, wird erwartet, dass Miniporttreiber PIN1 zuerst melden. Wenn beispielsweise die Berichterstellung von SubsidyLock und SIM PIN1 aktiviert ist, sollte die SubsidyLock-PIN (in einer nachfolgenden Abfrageanforderung) erst gemeldet werden, nachdem PIN1 erfolgreich überprüft wurde.
Die MB-API unterstützt zusätzlich zu PIN1 weitere PINs. Allerdings müsste ein Verbindungs-Manager/eine GUI von Drittanbietern installiert werden, da die Windows-Verbindungs-Manager/GUI nur PIN1 unterstützt.
Requirements (Anforderungen)
Version |
Verfügbar in Windows 7 und späteren Windows-Versionen. |
Header |
Ntddndis.h (include Ndis.h) |