Compartir a través de

Operaciones de PIN de MB

Información general

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 módulo de identidad de suscriptor (SIM). Esto incluye habilitar, deshabilitar o cambiar el número de identificación personal (PIN), así como desbloquear a través de PIN o clave de desbloqueo personal (PUK).

Arquitectura/flujos

Acciones de usuario para habilitar, deshabilitar, desbloquear o cambiar PIN

Diagrama de flujo que ilustra las acciones del usuario para habilitar, deshabilitar, desbloquear y cambiar el PIN.

Consulta de experiencia del usuario móvil para el estado PIN1/PUK1

Diagrama de flujo que muestra el proceso de consulta de los estados PIN1 y PUK1 en la experiencia de usuario móvil.

Desbloqueo automático después de reanudar desde la hibernación

Diagrama de flujo que muestra el proceso de desbloqueo automático después de reanudarse 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 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, 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 CDMA, este es un PIN que proporciona funcionalidad de verificación o identificación de encendido y para dispositivos basados en GSM, este es un PIN de módulo de identidad de suscriptor (SIM).

Las funciones deben poder devolver esta información cuando el estado de preparación cambia a MBIMSubscriberReadyStateInitialized o cuando el estado de preparación es MBIMSubscriberReadyStateDeviceLocked (bloqueado por PIN). Las funciones también deben devolver esta información en otros estados listos siempre que sea posible.

Consulta únicamente

InformationBuffer del mensaje consulta está vacío. El InformationBuffer de MBIM_COMMAND_DONE contiene un MBIM_PIN_LIST_INFO.

Parámetros

Establecer Consulta Notificación
Comando No disponible Empty No disponible
Respuesta No disponible MBIM_PIN_LIST_INFO No disponible

Estructuras de datos

MBIM_PIN_MODE

Tipos Importancia
MBIMPinModeNotSupported 0
MBIMPinModeEnabled 1
MBIMPinModeDisabled 2

MBIM_PIN_FORMAT (Formato de PIN)

Tipos Importancia
MBIMPinFormatUnknown 0
MBIMPinFormatNumeric 1
MBIMPinFormatAlphaNumeric 2

MBIM_PIN_DESC

Offset Tamaño 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 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 LongitudMínimaDePIN 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.

Consulta

InformationBuffer será null y InformationBufferLength será cero.

Respuesta

La estructura siguiente se usará en InformationBuffer:

MBIM_PIN_LIST_INFO

Offset Tamaño 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 CDMA, 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. Este es 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 la primera tarjeta SIM del dispositivo. Este es 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 es una estructura que define 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 en 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 desbloqueo del subsidio. Se trata de un PIN que permite que el dispositivo esté restringido a operar 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 (PIN requerido) Error en la operación de lista de PIN porque se debe escribir un PIN antes de que esta operación pueda continuar.

Ensayo

Las siguientes pruebas se ejecutan como parte de la lista de pruebas testPin HLK:

Nombre de la prueba Descripción
PinListQueryRadioOn Esta prueba intenta una consulta de lista de anclajes con la radio activada.
PinListaConsultaRadioDesactivado Esta prueba intenta una consulta de lista de anclajes 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.
ConjuntoDeDesactivaciónDePINIncorrectoConLongitudVálida Esta prueba intenta activar el PIN1 con un PIN incorrecto, pero de longitud válida.
HabilitarDeshabilitarPukAL travésDePinIncorrectoDesactivarEx Esta prueba habilita PUK1 escribiendo PIN1 incorrecto varias veces y, a continuación, deshabilita PUK1.
CambioConPinExAmbosInválidoYVálido Esta prueba habilita PIN1, cambia inmediatamente el PIN y lo deshabilita.
ReiniciarMáquinaDePruebaParaColocarPinEnEstadoDeBloqueo Esta prueba reinicia el dispositivo para que el módem entre en estado de bloqueo y solicite una entrada de PIN válida.
EntradaConPinVálidoPinExSet Esta prueba valida que el dispositivo está en estado de bloqueo para solicitar la entrada de código PIN.

La lista de pruebas testPowerStates HLK también contiene una prueba pertinente: 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

Configurar 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 pines

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 (clase)

Véase también

OID_WWAN_PIN_EX2

OID_WWAN_PIN_LIST

aplicación UICC MB y de acceso al sistema de archivos

Para obtener más información sobre las operaciones de PIN, consulte OID_WWAN_PIN.

  • Last updated on