Méthode IMbnPinManager ::GetPinList (mbnapi.h)
Important
À compter de Windows 10, version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.
Obtient la liste des différents types de code confidentiel pris en charge par l’appareil.
Syntaxe
HRESULT GetPinList(
[out, retval] SAFEARRAY **pinList
);
Paramètres
[out, retval] pinList
Pointeur vers une liste de valeurs MBN_PIN_TYPE qui représentent les types de code confidentiel pris en charge par l’appareil. Lorsque GetPinList retourne autre chose que S_OK, pinList a la valeur NULL. Sinon, l’application appelante doit libérer la mémoire allouée en appelant SafeArrayDestroy.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. |
|
Les types de code confidentiel ne sont pas disponibles. Le service Haut débit mobile est en train de sonder l’appareil pour obtenir les informations. Lorsque les types de code confidentiel sont disponibles, le service haut débit mobile appelle la méthode OnPinListAvailable de IMbnPinManagerEvents. |
|
L’appareil nécessite qu’un code confidentiel soit entré pour cette opération. |
|
La carte SIM n’est pas insérée. |
|
Une carte SIM incorrecte est insérée dans l’appareil. |
Remarques
Sur les erreurs récupérables E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED et E_MBN_BAD_SIM, le service haut débit mobile tente de récupérer ces informations à partir de l’appareil lorsque la condition d’erreur est terminée. Pendant qu’il récupère ces informations, l’appel GetPinList retourne E_PENDING. Une fois l’opération de récupération terminée, le service haut débit mobile appelle la méthode OnPinListAvailable de IMbnPinManagerEvents.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mbnapi.h |