Operaciones de PIN de MB
Introducción
En este tema se describen las operaciones relacionadas con el control de acceso de la información de suscripción almacenada en la memoria del dispositivo MB o en la tarjeta del módulo de identidad del suscriptor (SIM). Esto incluye habilitar, deshabilitar o cambiar el número de identificación personal (PIN), así como el desbloqueo mediante PIN o clave de desbloqueo personal (PUK).
Arquitectura/flujos
Acciones de usuario para habilitar, deshabilitar, desbloquear o cambiar PIN
Consulta de experiencia del usuario móvil para el estado PIN1/PUK1
Desbloqueo automático después de reanudar desde la hibernación
MBIM_CID_MS_PIN_EX
Este CID se describe aquí: MBIM_CID_MS_PIN_EX
MBIM_CID_PIN_LIST
Descripción
Este comando devuelve una lista de todos los diferentes tipos de números de identificación personal (PIN) admitidos por el dispositivo MB y detalles adicionales para cada tipo de PIN, como la longitud del PIN (longitudes mínimas y máximas), el formato de PIN y el modo de entrada de PIN (habilitado/ deshabilitado/no disponible). Este CID también especifica el modo actual de cada PIN admitido por la función . Las funciones deben notificar todos los PIN que admiten. Sin embargo, el PIN1 para dispositivos multimodo solo se debe notificar una vez.
Un PIN notificado como PIN1 debe cumplir con las directrices de PIN1: para los dispositivos basados en CONFIDENCIALIDAD, este es un PIN que proporciona funcionalidad de verificación o identificación de encendido, y para los dispositivos basados en GSM, se trata de un PIN del Módulo de identidad del suscriptor (SIM).
Las funciones deben poder devolver esta información cuando el estado listo cambia a MBIMSubscriberReadyStateInitialized o cuando el estado listo es MBIMSubscriberReadyStateDeviceLocked (PIN bloqueado). Las funciones también deben devolver esta información en otros estados listos siempre que sea posible.
Solo consulta
InformationBuffer del mensaje de consulta está vacío. InformationBuffer de MBIM_COMMAND_DONE contiene un MBIM_PIN_LIST_INFO.
Parámetros
| Set | Consultar | notificación | |
|---|---|---|---|
| Comando | N/D | Vacío | N/D |
| Respuesta | N/D | MBIM_PIN_LIST_INFO | N/D |
Estructuras de datos
MBIM_PIN_MODE
| Tipos | Value |
|---|---|
| MBIMPinModeNotSupported | 0 |
| MBIMPinModeEnabled | 1 |
| MBIMPinModeDisabled | 2 |
MBIM_PIN_FORMAT
| Tipos | Value |
|---|---|
| MBIMPinFormatUnknown | 0 |
| MBIMPinFormatNumeric | 1 |
| MBIMPinFormatAlphaNumeric | 2 |
MBIM_PIN_DESC
| Offset | Size | Campo | Tipo | Descripción |
|---|---|---|---|---|
| 0 | 4 | PinMode | MBIM_PIN_MODE | Consulte la tabla anterior MBIM_PIN_MODE. Esto muestra si el bloqueo está habilitado o no. No se muestra si el estado de bloqueo está bloqueado o desbloqueado. |
| 4 | 4 | PinFormat | MBIM_PIN_FORMAT | Consulte la tabla anterior MBIM_PIN_FORMAT. |
| 8 | 4 | PinLengthMin | UINT32 | Número mínimo de caracteres en el PIN. Los dispositivos no deben especificar un valor mayor que 16. Los dispositivos deben especificar 0xffffffff, si la longitud del PIN no está disponible. |
| 12 | 4 | PinLengthMax | UINT32 | Número máximo de caracteres en el PIN. Los dispositivos no deben especificar un valor mayor que 16. Los dispositivos deben especificar 0xffffffff, si la longitud del PIN no está disponible. |
Consultar
InformationBuffer será null y InformationBufferLength será cero.
Response
La estructura siguiente se usará en InformationBuffer:
MBIM_PIN_LIST_INFO
| Offset | Size | Campo | Tipo | Descripción |
|---|---|---|---|---|
| 0 | 16 | PinDescPin1 | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe PIN1. En el caso de los dispositivos GSMbased, se trata de un PIN del módulo de identidad de suscriptor (SIM). En el caso de los dispositivos basados en JAILBREAK, el bloqueo del dispositivo de encendido se notifica como PIN1. |
| 16 | 16 | PinDescPin2 | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe PIN2. Se trata de un PIN2 SIM que protege ciertas funciones sim. |
| 32 | 16 | PinDescDeviceSimPin | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN de dispositivo a tarjeta SIM. Se trata de un PIN que bloquea el dispositivo a una SIM específica. |
| 48 | 16 | PinDescDeviceFirstSimPin | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN de dispositivo a muy primera tarjeta SIM. Se trata de un PIN que bloquea el dispositivo a la SIM insertada por primera vez. |
| 64 | 16 | PinDescNetworkPin | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN de personalización de red. Se trata de un PIN que permite que el dispositivo se personalice en una red. Para obtener más información sobre este tipo de PIN, vea 3GPP specification 22.022. |
| 80 | 16 | PinDescNetworkSubsetPin | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN de personalización del subconjunto de red. Se trata de un PIN que permite que el dispositivo se personalice en un subconjunto de una red. Para obtener más información sobre este tipo de PIN, vea 3GPP specification 22.022. |
| 96 | 16 | PinDescServiceProviderPin | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN de personalización del proveedor de servicios (SP). Se trata de un PIN que permite que el dispositivo se personalice con un proveedor de servicios. Para obtener más información sobre este tipo de PIN, vea 3GPP specification 22.022. |
| 112 | 16 | PinDescCorporatePin | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN de personalización corporativa. Se trata de un PIN que permite que el dispositivo se personalice en una empresa específica. Para obtener más información sobre este tipo de PIN, vea 3GPP specification 22.022. |
| 128 | 16 | PinDescSubsidyLock | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN de desbloqueos de subvención. Se trata de un PIN que permite que el dispositivo esté restringido para funcionar en una red específica. Para obtener más información sobre este tipo de PIN, vea 3GPP specification 22.022. |
| 144 | 16 | PinDescCustom | MBIM_PIN_DESC | MBIM_PIN_DESC estructura que describe el PIN personalizado. Se trata de un tipo de PIN personalizado definido por el proveedor. No se incluye en la lista anterior. |
Códigos de estado
| Código de estado | Descripción |
|---|---|
| MBIM_STATUS_PIN_REQUIRED | Error en la operación de lista de PIN porque se debe escribir un PIN para poder continuar con esta operación. |
Prueba
Las siguientes pruebas se ejecutan como parte de la lista de pruebas de TestPin HLK:
| Nombre de la prueba | Descripción |
|---|---|
| PinListQueryRadioOn | Esta prueba intenta realizar una consulta de lista de patillas con la radio activada. |
| PinListQueryRadioOff | Esta prueba intenta una consulta de lista de patillas con la radio desactivada. |
| NoPinSupport | Esta prueba comprueba un dispositivo que no admite PIN1. |
| PinExSetEnableDisableWithValidPin | Esta prueba habilita y deshabilita PIN1 con un pin válido. |
| PinExSetDisableIncorrectPinWithValidLength | Esta prueba intenta habilitar PIN1 con un pin incorrecto con una longitud válida. |
| PukEnableDisableThroughIncorrectPinExDisable | Esta prueba habilita PUK1 escribiendo PIN1 incorrecto varias veces y, a continuación, deshabilita PUK1. |
| PinExSetChangeWithBothInvalidAndValidPin | Esta prueba habilita PIN1, cambia inmediatamente el PIN y lo deshabilita. |
| RebootTestMachineToPutPinIntoLockState | Esta prueba reinicia el dispositivo para que el módem entre en estado de bloqueo y solicite una entrada de PIN válida. |
| PinExSetEnterWithValidPin | Esta prueba valida que el dispositivo está en estado de bloqueo para solicitar la entrada de código PIN. |
La lista de pruebas de TestPowerStates HLK también contiene una prueba relevante: SimPinUnlockAfterHibernate.
Análisis de registro
Registros de ejemplo:
Desbloqueo automático:
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
Set Pin (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}}
Lista de patillas:
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
Consulte también
Mb UICC aplicación y acceso al sistema de archivos
Para obtener más información sobre las operaciones de PIN, consulte OID_WWAN_PIN.