OID_WWAN_PIN
OID_WWAN_PIN establece o devuelve información relacionada con números de identificación personal (PIN).
Los controladores de minipuerto deben procesar las solicitudes de establecimiento y consulta de forma asincrónica, devolviendo inicialmente NDIS_STATUS_INDICATION_REQUIRED a la solicitud original y, posteriormente, enviando una notificación de estado NDIS_STATUS_WWAN_PIN_INFO cuando hayan completado la solicitud de conjunto o consulta.
Los controladores de minipuerto deben enviar notificaciones de estado NDIS_STATUS_WWAN_PIN_INFO que contengan una estructura de NDIS_WWAN_PIN_INFO para devolver información de estado de entrada y tipo PIN, principalmente para indicar si se requiere un PIN para desbloquear el dispositivo MB o el módulo de identidad del suscriptor (tarjeta SIM) al completar las solicitudes de consulta.
Los autores de llamadas que solicitan establecer información relacionada con los PIN proporcionan una estructura de NDIS_WWAN_SET_PIN al controlador de minipuerto para enviar un PIN al dispositivo MB, habilitar o deshabilitar la configuración del PIN, o para cambiar un PIN en la SIM.
Observaciones
Consulte WWAN Pin Operations para obtener más información sobre el uso de este OID.
Los controladores de minipuerto de Windows 7 deben usar OID_WWAN_PIN. Windows 8 controladores de minipuerto deben usar OID_WWAN_PIN_EX.
Los controladores de minipuerto pueden acceder al módulo de identidad del suscriptor (tarjeta SIM) al procesar las operaciones de consulta, pero no deben acceder a la red del proveedor.
Durante el proceso de inicialización del controlador de miniporte, el servicio MB no continúa con el registro hasta que PIN1 se desbloquee correctamente, si está habilitado.
Los controladores de minipuerto proporcionan un valor pin, especificado por el usuario final, en el miembro PinAction.Pin de la estructura NDIS_WWAN_SET_PIN al procesar solicitudes establecidas. Solo cuando el valor del PIN coincide con el valor almacenado en la tarjeta SIM, el controlador de minipuerto procesará la solicitud. De lo contrario, los controladores de minipuerto deben producir un error en la solicitud establecida con el código de estado WWAN_STATUS_FAILURE.
Los dispositivos basados ens deben notificar el bloqueo del dispositivo encendido como PIN1.
Para todos los tipos de PIN admitidos, los controladores de minipuerto deben admitir la operación WwanPinOperationEnter . Además, si se admite PIN1, los controladores de minipuerto deben admitir las operaciones WwanPinOperationEnable, WwanPinOperationDisable y WwanPinOperationChange .
Si se intenta una operación de deshabilitación de PIN para un tipo de PIN cuando ese tipo de PIN está bloqueado, los controladores de minipuerto pueden producir un error en la solicitud con WWAN_STATUS_PIN_REQUIRED o pueden completar correctamente la solicitud. Si el controlador de minipuerto completa la solicitud correctamente, la operación de deshabilitación también debe desbloquear el PIN.
Si los informes de varios PIN están habilitados y solo se puede notificar un PIN a la vez, se espera que los controladores de miniporte informen primero de PIN1. Por ejemplo, si se habilitan los informes de SubsidyLock y SIM PIN1, el PIN de SubsidyLock debe notificarse (en una solicitud de consulta posterior) solo después de que PIN1 se haya comprobado correctamente.
La API de MB admite otros PIN además de PIN1. Sin embargo, es necesario instalar un administrador de conexiones o gui de terceros porque Windows Administrador de conexiones/GUI solo admite PIN1.
Requisitos
Versión |
Disponible en Windows 7 y versiones posteriores de Windows. |
Encabezado |
Ntddndis.h (incluye Ndis.h) |