OID_WWAN_PIN
OID_WWAN_PIN imposta o restituisce informazioni correlate ai numeri di identificazione personale (PIN).
I driver Miniport devono elaborare le richieste di set e query in modo asincrono, restituendo inizialmente NDIS_STATUS_INDICATION_REQUIRED alla richiesta originale e successivamente inviando una notifica di stato NDIS_STATUS_WWAN_PIN_INFO quando hanno completato la richiesta di impostazione o query.
I driver Miniport devono inviare notifiche di stato NDIS_STATUS_WWAN_PIN_INFO contenenti una struttura di NDIS_WWAN_PIN_INFO per restituire informazioni sullo stato di immissione del PIN e del PIN, principalmente per indicare se è necessario un PIN per sbloccare il dispositivo MB o il modulo di identità del Sottoscrittore (scheda SIM) durante il completamento delle richieste di query.
I chiamanti che richiedono di impostare le informazioni relative ai PIN forniscono una struttura NDIS_WWAN_SET_PIN al driver miniport per inviare un PIN al dispositivo MB, abilitare o disabilitare le impostazioni del PIN o modificare un PIN nella SIM.
Commenti
Per altre informazioni sull'uso di questo OID, vedere Operazioni pin WWAN .
I driver miniport di Windows 7 devono usare OID_WWAN_PIN. Windows 8 driver miniport devono usare OID_WWAN_PIN_EX.
I driver Miniport possono accedere al Modulo identità sottoscrittore (scheda SIM) durante l'elaborazione delle operazioni di query, ma non devono accedere alla rete del provider.
Durante il processo di inizializzazione del driver miniport, il servizio MB non procede alla registrazione fino a quando PIN1 non viene sbloccato correttamente, se abilitato.
I driver Miniport forniscono un valore PIN, immesso dall'utente finale, nel membro PinAction.Pin della struttura NDIS_WWAN_SET_PIN durante l'elaborazione delle richieste impostate. Solo quando il valore del PIN corrisponde al valore archiviato nella scheda SIM deve essere elaborato dal driver miniport. In caso contrario, i driver miniport devono non riuscire la richiesta impostata con il codice di stato WWAN_STATUS_FAILURE.
I dispositivi basati su CDMA devono segnalare il blocco del dispositivo attivo come PIN1.
Per tutti i tipi di PIN supportati, i driver miniport devono supportare l'operazione WwanPinOperationEnter . Inoltre, se PIN1 è supportato, i driver miniport devono supportare le operazioni WwanPinOperationEnable, WwanPinOperationDisable e WwanPinOperationChange .
Se viene tentata un'operazione di disabilitazione PIN per un tipo di PIN quando tale tipo di PIN è bloccato, i driver miniport possono non riuscire la richiesta con WWAN_STATUS_PIN_REQUIRED oppure completare correttamente la richiesta. Se il driver miniport completa correttamente la richiesta, l'operazione di disabilitazione deve anche sbloccare il PIN.
Se la segnalazione di più PIN è abilitata e è possibile segnalare un solo PIN alla volta, i driver miniport devono prima segnalare PIN1. Ad esempio, se la segnalazione di SubsidyLock e SIM PIN1 è abilitata, il PIN di SubsidyLock deve essere segnalato (in una richiesta di query successiva) solo dopo che PIN1 è stato verificato correttamente.
L'API MB supporta altri PIN oltre a PIN1. Tuttavia, è necessario installare una gestione connessione/GUI di terze parti perché Windows Gestione connessioni/GUI supporta solo PIN1.
Requisiti
Versione |
Disponibile in Windows 7 e versioni successive di Windows. |
Intestazione |
Ntddndis.h (include Ndis.h) |