Partager via


OID_WWAN_PIN

OID_WWAN_PIN définit ou retourne des informations relatives aux numéros d’identification personnels (PIN).

Les pilotes miniport doivent traiter les demandes définies et de requête de manière asynchrone, en retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine, puis en envoyant une notification d’état NDIS_STATUS_WWAN_PIN_INFO lorsqu’ils ont terminé l’ensemble ou la demande de requête.

Les pilotes miniport doivent envoyer NDIS_STATUS_WWAN_PIN_INFO notifications d’état contenant une structure de NDIS_WWAN_PIN_INFO pour retourner des informations d’état de type pin et d’entrée de code confidentiel, principalement pour indiquer si un code confidentiel est nécessaire pour déverrouiller l’appareil Mo ou la carte SIM (carte SIM) lors de la fin des demandes de requête.

Les appelants demandant de définir des informations relatives aux codes CONFIDENTIELs fournissent une structure NDIS_WWAN_SET_PIN au pilote miniport pour envoyer un code confidentiel à l’appareil Mo, activer ou désactiver les paramètres de code confidentiel, ou pour modifier un code confidentiel sur la carte SIM.

Remarques

Pour plus d’informations sur l’utilisation de cet OID, consultez opérations de broche WWAN.

Les pilotes miniport Windows 7 doivent utiliser OID_WWAN_PIN. Les pilotes miniport Windows 8 doivent utiliser OID_WWAN_PIN_EX.

Les pilotes miniport peuvent accéder au module d’identité de l’abonné (carte SIM) lors du traitement des opérations de requête, mais ne doivent pas accéder au réseau du fournisseur.

Pendant le processus d’initialisation du pilote miniport, le service Mb ne passe pas à l’inscription tant que le code PIN1 n’est pas correctement déverrouillé, s’il est activé.

Les pilotes miniport fournissent une valeur de code confidentiel, entrée par l’utilisateur final, dans la PinAction.Pin membre de la structure NDIS_WWAN_SET_PIN lors du traitement des demandes définies. Uniquement lorsque la valeur du code confidentiel correspond à la valeur stockée dans la carte SIM, la demande doit être traitée par le pilote miniport. Sinon, les pilotes miniport doivent échouer à la demande définie avec le code d’état WWAN_STATUS_FAILURE.

Les appareils CDMA doivent signaler le verrouillage de l’appareil sous forme de code PIN1.

Pour tous les types de code confidentiel pris en charge, les pilotes miniport doivent prendre en charge l’opération WwanPinOperationEnter. En outre, si pin1 est pris en charge, les pilotes miniport doivent prendre en charge les opérations WwanPinOperationEnable, WwanPinOperationDisableet opérations WwanPinOperationChange.

Si une opération de désactivation du code confidentiel pour un type de code confidentiel est tentée lorsque ce type de code confidentiel est verrouillé, les pilotes miniports peuvent échouer la requête avec WWAN_STATUS_PIN_REQUIRED ou ils peuvent terminer la requête. Si le pilote miniport termine la requête avec succès, l’opération de désactivation doit également déverrouiller le code confidentiel.

Si le signalement de plusieurs codes CONFIDENTIELs est activé et qu’un seul code confidentiel peut être signalé à la fois, les pilotes miniport doivent d’abord signaler le code PIN1. Par exemple, si la déclaration de SubsidyLock et du code PIN1 SIM est activée, le code confidentiel De SubventionLock doit être signalé (dans une demande de requête ultérieure) uniquement après la vérification du code PIN1.

L’API Mo prend en charge d’autres codes CONFIDENTIELs en plus du code PIN1. Toutefois, un gestionnaire de connexions/gui tiers doit être installé, car le Gestionnaire de connexions/GUI Windows prend uniquement en charge le code PIN1.

Exigences

Version

Disponible dans Windows 7 et versions ultérieures de Windows.

En-tête

Ntddndis.h (include Ndis.h)

Voir aussi

NDIS_WWAN_PIN_INFO

NDIS_WWAN_SET_PIN

NDIS_STATUS_WWAN_PIN_INFO

opérations de broche WWAN