OID_WWAN_PIN
OID_WWAN_PIN Legt Informationen zu persönlichen Identifikationsnummern (Personal Identification Numbers, PINs) fest oder gibt diese zurück.
Miniport-Treiber müssen Satz- und Abfrageanforderungen asynchron verarbeiten, zunächst NDIS_STATUS_INDICATION_REQUIRED an die ursprüngliche Anforderung zurückgeben und später eine NDIS_STATUS_WWAN_PIN_INFO Statusbenachrichtigung senden, wenn sie die Satz- oder Abfrageanforderung abgeschlossen haben.
Miniport-Treiber sollten NDIS_STATUS_WWAN_PIN_INFO Statusbenachrichtigungen 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 zum Entsperren des MB-Geräts oder des Abonnentenidentitätsmoduls (SIM-Karte) beim Abschließen von Abfrageanforderungen erforderlich ist.
Anrufer, die anfordern, Informationen im Zusammenhang mit PINs festzulegen, 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 dieses OID finden Sie unter WWAN Pin Operations.
Windows 7-Miniporttreiber sollten OID_WWAN_PIN verwenden. Windows 8-Miniporttreiber sollten OID_WWAN_PIN_EXverwenden.
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 des Miniporttreiberinitialisierungsprozesses wird der MB-Dienst erst dann mit der Registrierung fortfahren, wenn PIN1 erfolgreich entsperrt wurde, wenn dies aktiviert ist.
Miniport-Treiber stellen einen PIN-Wert bereit, der vom Endbenutzer eingegeben wird, im PinAction.Pin Mitglied der NDIS_WWAN_SET_PIN-Struktur beim Verarbeiten von Setanforderungen. Nur wenn der PIN-Wert mit dem in der SIM-Karte gespeicherten Wert übereinstimmt, sollte die Anforderung vom Miniporttreiber verarbeitet werden. Andernfalls sollten Miniporttreiber die set-Anforderung mit Statuscode WWAN_STATUS_FAILURE nicht ausführen.
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 die WwanPinOperationEnable-, WwanPinOperationDisable-und WwanPinOperationChange--Vorgänge unterstützen.
Wenn ein PIN-Deaktivierungsvorgang für einen PIN-Typ versucht wird, wenn dieser PIN-Typ gesperrt ist, können Miniporttreiber entweder die Anforderung 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 Berichterstellung mehrerer PINs aktiviert ist und jeweils nur eine PIN gemeldet werden kann, wird erwartet, dass Miniporttreiber PIN1 zuerst melden. Wenn beispielsweise die Berichterstellung von SubventionLock und SIM-PIN1 aktiviert ist, sollte die SubventionLock-PIN (in einer nachfolgenden Abfrageanforderung) nur gemeldet werden, nachdem PIN1 erfolgreich überprüft wurde.
Die MB-API unterstützt zusätzlich zu PIN1 andere PINs. Ein Verbindungs-Manager/GUI eines Drittanbieters muss jedoch installiert werden, da der Windows-Verbindungs-Manager/die GUI nur PIN1 unterstützt.
Anforderungen
Version |
Verfügbar in Windows 7 und höheren Versionen von Windows. |
Kopfball |
Ntddndis.h (include Ndis.h) |