Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Überblick
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. Dazu gehört das Aktivieren, Deaktivieren oder Ändern der PIN (Personal Identification Number) sowie das Entsperren über PIN oder den persönlichen Entsperrungsschlüssel (PUK).
Architektur/Flüsse
Benutzeraktionen zum Aktivieren/Deaktivieren/Entsperren/Ändern der PIN
Mobilfunk-UX-Anfrage zum Status von PIN1/PUK1
Automatische Entsperrung nach dem Fortsetzen des Ruhezustands
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 (PERSONAL Identification Numbers, PINs) zurück, die vom MB-Gerät unterstützt werden, und zusätzliche Details für jeden PIN-Typ, z. B. die Länge der PIN (Mindest- 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: Bei CDMA-basierten Geräten handelt es sich um eine PIN, die eine Überprüfungs- oder Identifikationsfunktion bereitstellt, und für GSM-basierte Geräte ist dies eine SIM-PIN (Subscriber Identity Module).
Funktionen müssen diese Informationen zurückgeben können, wenn sich der Ready-State in MBIMSubscriberReadyStateInitialized ändert oder wenn der Ready-State MBIMSubscriberReadyStateDeviceLocked (PIN gesperrt) ist. Funktionen sollten diese Informationen auch nach Möglichkeit in anderen Bereitschaftszuständen zurückgeben.
Nur Abfrage
Der InformationBuffer der Abfragenachricht ist leer. Der Informationspuffer von MBIM_COMMAND_DONE enthält eine MBIM_PIN_LIST_INFO.
Die Parameter
| Set | Abfrage | Benachrichtigung | |
|---|---|---|---|
| Befehl | Nicht verfügbar | Leer | Nicht verfügbar |
| Antwort | Nicht verfügbar | MBIM_PIN_LIST_INFO | Nicht verfügbar |
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 | Größe | Feld | Typ | BESCHREIBUNG |
|---|---|---|---|---|
| 0 | 4 | PinMode | MBIM_PIN_MODE | Siehe oben Tabelle MBIM_PIN_MODE. Dies zeigt, ob die Sperre aktiviert ist oder nicht. Es wird nicht angezeigt, ob der Sperrzustand gesperrt oder entsperrt ist. |
| 4 | 4 | PinFormat | MBIM_PIN_FORMAT | Siehe oben Tabelle MBIM_PIN_FORMAT. |
| 8 | 4 | PinLengthMin | UINT32 | Die mindeste 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. |
| 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 sein, und "InformationBufferLength" muss null sein.
Antwort
Die folgende Struktur muss im InformationBuffer verwendet werden:
MBIM_PIN_LIST_INFO
| Offset | Größe | Feld | Typ | 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. Bei CDMA-basierten Geräten wird die Einschaltgerätesperre als PIN1 gemeldet. |
| 16 | 16 | PinDescPin2 | MBIM_PIN_DESC | MBIM_PIN_DESC Struktur, die PIN2 beschreibt. Dies ist eine SIM-PIN2, die bestimmte SIM-Funktionen schützt. |
| 32 | 16 | PinDescDeviceSimPin | MBIM_PIN_DESC | Die MBIM_PIN_DESC-Struktur, die die PIN von Gerät zu SIM-Karte beschreibt. Dies ist eine PIN, die das Gerät auf eine bestimmte SIM-Karte sperrt. |
| 48 | 16 | PinDescDeviceFirstSimPin | MBIM_PIN_DESC | MBIM_PIN_DESC Struktur, die die PIN des Geräts zur allerersten SIM-Karte beschreibt. Dies ist eine PIN, die das Gerät an die erste eingefügte SIM 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 in der 3GPP-Spezifikation 22.022. |
| 80 | 16 | PinDescNetworkSubsetPin | MBIM_PIN_DESC | MBIM_PIN_DESC Struktur zur Beschreibung der PIN für die Personalisierung der Netzwerkuntergruppe. 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 in der 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 in der 3GPP-Spezifikation 22.022. |
| 112 | 16 | PinDescCorporatePin | MBIM_PIN_DESC | MBIM_PIN_DESC Struktur, die die PIN für die Unternehmenspersonalisierung beschreibt. Dies ist eine PIN, mit der das Gerät an ein bestimmtes Unternehmen personalisiert werden kann. Weitere Informationen zu diesem PIN-Typ finden Sie in der 3GPP-Spezifikation 22.022. |
| 128 | 16 | PinDescSubsidyLock | MBIM_PIN_DESC | MBIM_PIN_DESC Struktur, die die Freischaltung eines Subventions-PIN beschreibt. Dies ist eine PIN, mit der das Gerät auf den Betrieb in einem bestimmten Netzwerk beschränkt werden kann. Weitere Informationen zu diesem PIN-Typ finden Sie in der 3GPP-Spezifikation 22.022. |
| 144 | 16 | PinDescCustom | MBIM_PIN_DESC | MBIM_PIN_DESC Struktur, die die benutzerdefinierte PIN beschreibt. Dies ist ein benutzerdefinierter herstellerdefinierter 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 aktiviertem Radio. |
| PinListQueryRadioOff | Bei diesem Test wird eine Pinlistenabfrage mit deaktiviertem Funkgerät versucht. |
| NoPinSupport | Dieser Test überprüft ein Gerät, das PIN1 nicht unterstützt. |
| PinExSetEnableDisableWithValidPin | Dieser Test aktiviert und deaktiviert PIN1 mit einem gültigen Pin. |
| PinExSetDeaktivierenFalschePinMitGültigerLänge | Dieser Test versucht, PIN1 mit einem falschen PIN mit gültiger Länge zu aktivieren. |
| PukAktivierenDeaktivierenDurchFalschePinExDeaktivierung | Dieser Test ermöglicht PUK1 durch mehrfaches Eingeben falscher PIN1 und deaktiviert dann PUK1. |
| PinExSetÄnderungMitSowohlUngültigerAlsAuchGültigerPIN | Dieser Test aktiviert PIN1, ändert die PIN sofort und deaktiviert sie. |
| Neustarten des Testgeräts, um den PIN in den Sperrzustand zu versetzen | Dieser Test startet das Gerät neu, damit das Modem in den Sperrzustand wechselt und einen gültigen PIN-Eintrag einfordert. |
| PinExSetEingebenMitGültigerPin | 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}}
Pinnliste
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
Siehe auch
MB UICC-Anwendung und Dateisystemzugriff
Weitere Informationen zu PIN-Vorgängen finden Sie unter OID_WWAN_PIN.