MB-PIN-Vorgänge

  • Artikel

Übersicht

In diesem Thema werden die Vorgänge im Zusammenhang mit der Zugriffssteuerung von Abonnementinformationen beschrieben, die entweder im MB-Gerätespeicher oder auf der SIM-Karte (Subscriber Identity Module) gespeichert sind. Dies umfasst das Aktivieren, Deaktivieren oder Ändern der persönlichen Identifikationsnummer (PIN) sowie das Entsperren per PIN oder persönlichem Entsperrschlüssel (PUK).

Architektur/Flows

Benutzeraktionen zum Aktivieren/Deaktivieren/Entsperren/Ändern der PIN

Flussdiagramm, das Benutzeraktionen zum Aktivieren, Deaktivieren, Entsperren und Ändern der PIN veranschaulicht.

Mobilfunk-UX-Abfrage für PIN1/PUK1-Status

Flussdiagramm, das den Prozess der Abfrage von PIN1- und PUK1-Zuständen in der Mobilfunk-UX darstellt.

Automatische Entsperrung nach dem Fortsetzen des Ruhezustands

Flussdiagramm, das den Automatischentsperrungsprozess nach dem Fortsetzen des Ruhezustands anzeigt.

MBIM_CID_MS_PIN_EX

Diese CID wird hier beschrieben: MBIM_CID_MS_PIN_EX

MBIM_CID_PIN_LIST

Beschreibung

Dieser Befehl gibt eine Liste aller verschiedenen Typen von persönlichen Identifikationsnummern (PINs) zurück, die vom MB-Gerät unterstützt werden, sowie zusätzliche Details für jeden PIN-Typ, z. B. die Länge der PIN (minimale und maximale Länge), das PIN-Format und den PIN-Eingabemodus (aktiviert/deaktiviert/nicht verfügbar). Diese CID gibt auch den aktuellen Modus jeder PIN an, die von der Funktion unterstützt wird. Funktionen müssen alle unterstützten PINs melden. PIN1 für Geräte mit mehreren Modus darf jedoch nur einmal gemeldet werden.

Eine PIN, die als PIN1 gemeldet wird, muss den PIN1-Richtlinien entsprechen: Für CDMA-basierte Geräte ist dies eine PIN, die Power-On-Überprüfungs- oder Identifikationsfunktionen bietet, und für GSM-basierte Geräte ist dies eine SIM-PIN (Subscriber Identity Module).

Funktionen müssen in der Lage sein, diese Informationen zurückzugeben, wenn sich der Bereitzustand in MBIMSubscriberReadyStateInitialized ändert oder wenn der Ready-Zustand MBIMSubscriberReadyStateDeviceLocked ist (PIN gesperrt). Funktionen sollten diese Informationen auch in anderen Ready-Status zurückgeben, wenn möglich.

Nur Abfrage

InformationBuffer der Abfragemeldung ist leer. InformationBuffer von MBIM_COMMAND_DONE enthält eine MBIM_PIN_LIST_INFO.

Parameter

Set Abfrage Benachrichtigung
Befehl – Empty –
Antwort – MBIM_PIN_LIST_INFO –

Datenstrukturen

MBIM_PIN_MODE

Typen Wert
MBIMPinModeNotSupported 0
MBIMPinModeEnabled 1
MBIMPinModeDisabled 2

MBIM_PIN_FORMAT

Typen Wert
MBIMPinFormatUnknown 0
MBIMPinFormatNumeric 1
MBIMPinFormatAlphaNumeric 2

MBIM_PIN_DESC

Offset Size Feld type Beschreibung
0 4 PinMode MBIM_PIN_MODE Siehe tabelle MBIM_PIN_MODE oben. Dies zeigt an, ob die Sperre aktiviert ist oder nicht. Es wird nicht angezeigt, ob der Sperrstatus gesperrt oder entsperrt ist.
4 4 PinFormat MBIM_PIN_FORMAT Siehe tabelle MBIM_PIN_FORMAT oben.
8 4 PinLengthMin UINT32 Die Mindestanzahl von Zeichen in der PIN. Geräte sollten keinen Wert angeben, der größer als 16 ist. Geräte sollten 0xffffffff angeben, wenn die PIN-Länge nicht verfügbar ist.
12 4 PinLengthMax UINT32 Die maximale Anzahl von Zeichen in der PIN. Geräte sollten keinen Wert angeben, der größer als 16 ist. Geräte sollten 0xffffffff angeben, wenn die PIN-Länge nicht verfügbar ist.

Abfrage

Der InformationBuffer muss NULL und InformationBufferLength null sein.

Antwort

Die folgende Struktur ist im InformationBuffer zu verwenden:

MBIM_PIN_LIST_INFO

Offset Size Feld type Beschreibung
0 16 PinDescPin1 MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die PIN1 beschreibt. Für GSM-basierte Geräte ist dies eine SIM-PIN (Subscriber Identity Module). Für CDMA-basierte Geräte wird die Einschaltgerätesperre als PIN1 gemeldet.
16 16 PinDescPin2 MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die PIN2 beschreibt. Hierbei handelt es sich um eine SIM-PIN2, die bestimmte SIM-Funktionen schützt.
32 16 PinDescDeviceSimPin MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die die Device-to-SIM-Karte PIN beschreibt. Dies ist eine PIN, die das Gerät an eine bestimmte SIM-Karte sperrt.
48 16 PinDescDeviceFirstSimPin MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die geräte-zu-sehr-erste-SIM-Karte-PIN beschreibt. Dies ist eine PIN, die das Gerät mit der ersten eingesteckten SIM-Karte sperrt.
64 16 PinDescNetworkPin MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die die Netzwerkpersonalisierungs-PIN beschreibt. Dies ist eine PIN, mit der das Gerät in ein Netzwerk personalisiert werden kann. Weitere Informationen zu diesem PIN-Typ finden Sie unter 3GPP-Spezifikation 22.022.
80 16 PinDescNetworkSubsetPin MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die die Netzwerkteilset-Personalisierungs-PIN beschreibt. Dies ist eine PIN, mit der das Gerät in eine Teilmenge eines Netzwerks personalisiert werden kann. Weitere Informationen zu diesem PIN-Typ finden Sie unter 3GPP-Spezifikation 22.022.
96 16 PinDescServiceProviderPin MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die die Personalisierungs-PIN des Dienstanbieters (SP) beschreibt. Dies ist eine PIN, mit der das Gerät an einen Dienstanbieter personalisiert werden kann. Weitere Informationen zu diesem PIN-Typ finden Sie unter 3GPP-Spezifikation 22.022.
112 16 PinDescCorporatePin MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die die Personalisierungs-PIN des Unternehmens beschreibt. Dies ist eine PIN, mit der das Gerät für ein bestimmtes Unternehmen personalisiert werden kann. Weitere Informationen zu diesem PIN-Typ finden Sie unter 3GPP-Spezifikation 22.022.
128 16 PinDescSubsidyLock MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die die Subvention beschreibt, entsperrt PIN. Dies ist eine PIN, mit der das Gerät für den Betrieb in einem bestimmten Netzwerk eingeschränkt werden kann. Weitere Informationen zu diesem PIN-Typ finden Sie unter 3GPP-Spezifikation 22.022.
144 16 PinDescCustom MBIM_PIN_DESC MBIM_PIN_DESC Struktur, die die benutzerdefinierte PIN beschreibt. Hierbei handelt es sich um einen benutzerdefinierten vom Anbieter definierten PIN-Typ. Sie ist nicht in der obigen Liste enthalten.

Statuscodes

Statuscode BESCHREIBUNG
MBIM_STATUS_PIN_REQUIRED Fehler beim Vorgang der PIN-Liste, da eine PIN eingegeben werden muss, bevor dieser Vorgang fortgesetzt werden kann.

Testen

Die folgenden Tests werden als Teil der TestPin HLK-Testliste ausgeführt:

Prüfungsname BESCHREIBUNG
PinListQueryRadioOn Dieser Test versucht eine Pinlistenabfrage mit eingeschaltetem Radio.
PinListQueryRadioOff Bei diesem Test wird eine Anheftlistenabfrage mit ausgeschaltetem Funkgerät versucht.
NoPinSupport Dieser Test überprüft ein Gerät, das PIN1 nicht unterstützt.
PinExSetEnableDisableWithValidPin Dieser Test aktiviert und deaktiviert PIN1 mit einer gültigen Pin.
PinExSetDisableIncorrectPinWithValidLength Dieser Test versucht, PIN1 mit einem falschen Pin mit gültiger Länge zu aktivieren.
PukEnableDisableThroughIncorrectPinExDisable Dieser Test aktiviert PUK1 durch mehrfache Eingabe einer falschen PIN1 und deaktiviert dann PUK1.
PinExSetChangeWithBothInvalidAndValidPin Dieser Test aktiviert PIN1, ändert sofort die PIN und deaktiviert sie.
RebootTestMachineToPutPinIntoLockState Bei diesem Test wird das Gerät neu gestartet, um das Modem in den Sperrzustand zu versetzen und eine gültige PIN-Eingabe einzufordern.
PinExSetEnterWithValidPin Dieser Test überprüft, ob sich das Gerät im Sperrzustand befindet, um die PIN-Codeeingabe anzufordern.

Die TestPowerStates HLK-Testliste enthält auch einen relevanten Test – SimPinUnlockAfterHibernate.

Protokollanalyse

Beispielprotokolle:

Automatische Entsperrung:

462678 [0]0F3C.1280::2020-05-05 13:03:46.378805100 [Microsoft-Windows-WWAN-SVC-EVENTS][Request=0x53] Received PinInfo, status=WWAN_STATUS_SUCCESS , Type=WwanPinTypePin1  State=WwanPinStateEnter  Attempts=3, miniport={7971731f-33f9-4f1a-9718-087c12e64c5d} 
462753 [7]0F3C.2A6C::2020-05-05 13:03:46.379718400 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::maybeUnlockPin:  Attempting auto-PIN-unlock. Interface: {{7971731f-33f9-4f1a-9718-087c12e64c5d}} 
462809 [7]0F3C.2A6C::2020-05-05 13:03:46.380157500 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Error] CWwanPinSM::maybeUnlockPin: Attempt to auto-unlock PIN succeeded

Pin festlegen (WwanPinTypePin1):

546408 [3]0F3C.1240::2020/05/02-09:18:09.178460200 [Microsoft-Windows-WWAN-SVC-EVENTS][Request=0x6C] Sent SET PinAction, Type=2(WwanPinTypePin1), Operation=0(WwanPinOperationEnter), miniport={7971731f-33f9-4f1a-9718-087c12e64c5d}, ErrorCode=3407873(WIN=The request will be completed later by NDIS status indication.)
546425 [1]3DB0.12EC::2020/05/02-09:18:09.178564700 [Microsoft.Windows.CellCore.MBBSettingsUX]{"meta":{"provider":"Microsoft.Windows.CellCore.MBBSettingsUX","event":"MBCategory::_SetPinAction. WwanSetInterface succeeded","time":"2020-05-02T16:18:09.1785647Z","cpu":1,"pid":15792,"tid":4844,"channel":11,"level":4}}
546644 [2]0F3C.39E4::2020/05/02-09:18:09.426362600 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::processPinActionResponse: SetPin rsp rcvd (result:0x0) PIN Info (state:1, type:3, attemptsRemaining:3) IsPin1Blocked 0
546645 [2]0F3C.39E4::2020/05/02-09:18:09.426364800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::maybeCapturePin: Capturing PIN for PIN ENTER/ENABLE operation Interface: {{7971731f-33f9-4f1a-9718-087c12e64c5d}}
546688 [7]3B64.2A80::2020/05/02-09:18:09.426727000 [MbaeApiLogging]{"NotificationCode":"WwanMsmEventTypePinActionComplete: Success","AdapterID":"{7971731f-33f9-4f1a-9718-087c12e64c5d}","NotificationSize":24,"meta":{"provider":"MbaeApiLogging","event":"CWwanTranslator::ProcessWwanNotification","time":"2020-05-02T16:18:09.4267270Z","cpu":7,"pid":15204,"tid":10880,"channel":11,"level":5}}
546702 [0]3B64.242C::2020/05/02-09:18:09.426762000 [Microsoft.Windows.CellCore.MBBSettingsUX]{"meta":{"provider":"Microsoft.Windows.CellCore.MBBSettingsUX","event":"MBMediaManager::ProcessWwanNotification WwanMsmEventTypePinActionComplete","time":"2020-05-02T16:18:09.4267620Z","cpu":0,"pid":15204,"tid":9260,"channel":11,"level":4}}
546710 [7]0F3C.1208::2020/05/02-09:18:09.426809700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] _PublishSebNotification: Event Source=WwanNotificationSourceMsm, Code=WwanMsmEventTypePinActionComplete
547064 [2]3DB0.1194::2020/05/02-09:18:09.427921200 [MbaeApiLogging]{"NotificationCode":"WwanMsmEventTypePinActionComplete: Success","AdapterID":"{7971731f-33f9-4f1a-9718-087c12e64c5d}","NotificationSize":24,"meta":{"provider":"MbaeApiLogging","event":"CWwanTranslator::ProcessWwanNotification","time":"2020-05-02T16:18:09.4279212Z","cpu":2,"pid":15792,"tid":4500,"channel":11,"level":5}}
547106 [2]3DB0.0B38::2020/05/02-09:18:09.428040100 [Microsoft.Windows.CellCore.MBBSettingsUX]{"meta":{"provider":"Microsoft.Windows.CellCore.MBBSettingsUX","event":"MBMediaManager::ProcessWwanNotification WwanMsmEventTypePinActionComplete","time":"2020-05-02T16:18:09.4280401Z","cpu":2,"pid":15792,"tid":2872,"channel":11,"level":4}}

Liste anheften:

465632 [4]0F3C.47F4::2020-05-05 13:03:46.395488200 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: PIN1 (mode:1, format:1, pinlnmin:4, pinlnmax:8) 
465633 [4]0F3C.47F4::2020-05-05 13:03:46.395489800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: PIN2 (mode:1, format:1, pinlnmin:4, pinlnmax:8) 
465634 [4]0F3C.47F4::2020-05-05 13:03:46.395491400 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: DEVSIMPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0) 
465635 [4]0F3C.47F4::2020-05-05 13:03:46.395492800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: DEVFIRSTSIMPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0) 
465636 [4]0F3C.47F4::2020-05-05 13:03:46.395494200 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: NWPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0) 
465637 [4]0F3C.47F4::2020-05-05 13:03:46.395495800 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: NWSUBSETPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0) 
465641 [5]0F3C.47F4::2020-05-05 13:03:46.395510100 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: SVCPROVIDERPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0) 
465643 [5]0F3C.47F4::2020-05-05 13:03:46.395513700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: CORPORATEPIN (mode:0, format:0, pinlnmin:0, pinlnmax:0) 
465644 [5]0F3C.47F4::2020-05-05 13:03:46.395515200 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanPinSM::tracePinDesc: SUBSIDYLOCK (mode:0, format:0, pinlnmin:0, pinlnmax:0)

WinRT-API

MobileBroadbandPin-Klasse

Weitere Informationen

OID_WWAN_PIN_EX2

OID_WWAN_PIN_LIST

MB UICC-Anwendungs- und Dateisystemzugriff

Weitere Informationen zu PIN-Vorgängen finden Sie unter OID_WWAN_PIN.