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 de manière asynchrone les requêtes définies et interrogées, en retournant initialement NDIS_STATUS_INDICATION_REQUIRED à la demande d’origine, puis en envoyant une notification NDIS_STATUS_WWAN_PIN_INFO status une fois qu’ils ont terminé la demande d’ensemble ou de requête.
Les pilotes miniport doivent envoyer NDIS_STATUS_WWAN_PIN_INFO status notifications contenant une structure NDIS_WWAN_PIN_INFO pour renvoyer des informations de type pin et d’état d’entrée de code confidentiel, principalement pour indiquer si un code confidentiel est nécessaire pour déverrouiller l’appareil Mo ou le module d’identité de l’abonné (carte SIM) lors de l’exécution des demandes de requête.
Les appelants qui demandent à définir des informations relatives aux codes PIN 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 du code confidentiel ou modifier un code confidentiel sur la carte SIM.
Notes
Pour plus d’informations sur l’utilisation de cet OID, consultez Opérations de broche WWAN .
Les pilotes windows 7 miniport doivent utiliser OID_WWAN_PIN. Windows 8 pilotes miniport doivent utiliser OID_WWAN_PIN_EX.
Les pilotes Miniport peuvent accéder au module d’identité de l’abonné (SIM carte) lors du traitement des opérations de requête, mais ils ne doivent pas accéder au réseau du fournisseur.
Pendant le processus d’initialisation du pilote miniport, le service MO ne passe pas à l’inscription tant que le code PIN1 n’est pas déverrouillé, s’il est activé.
Les pilotes miniport fournissent une valeur de code confidentiel, entrée par l’utilisateur final, dans le membre PinAction.Pin de la structure NDIS_WWAN_SET_PIN lors du traitement des demandes de jeu. Ce n’est que lorsque la valeur du code confidentiel correspond à la valeur stockée dans le carte SIM que la demande doit être traitée par le pilote miniport. Dans le cas contraire, les pilotes miniport doivent échouer à la demande de jeu avec status code WWAN_STATUS_FAILURE.
Les appareils CDMA doivent signaler le verrouillage de l’appareil de mise sous tension en tant que 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, WwanPinOperationDisable et 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 miniport peuvent soit échouer la demande avec WWAN_STATUS_PIN_REQUIRED, soit terminer la demande avec succès. Si le pilote miniport termine la demande avec succès, l’opération de désactivation doit également déverrouiller le code confidentiel.
Si la création de rapports sur plusieurs codes CONFIDENTIELs est activée et qu’un seul code pin peut être signalé à la fois, les pilotes miniports doivent d’abord signaler le code PIN1. Par exemple, si la création de rapports sur SubsidyLock et SIM PIN1 est activée, le code PIN SubsidyLock ne doit être signalé (dans une demande de requête suivante) qu’une fois que PIN1 a été correctement vérifié.
L’API MB prend en charge d’autres codes PIN en plus du code PIN1. Toutefois, un gestionnaire de connexions tiers/une interface graphique utilisateur doit être installé, car windows Gestionnaire des connexions/GUI ne prend en charge que le code PIN1.
Spécifications
Version |
Disponible dans Windows 7 et versions ultérieures de Windows. |
En-tête |
Ntddndis.h (inclure Ndis.h) |