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
S_OK
La commande s'est correctement terminée.
E_PENDING
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.
E_MBN_PIN_REQUIRED
L’appareil nécessite qu’un code confidentiel soit entré pour cette opération.
E_MBN_SIM_NOT_INSERTED
La carte SIM n’est pas insérée.
E_MBN_BAD_SIM
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

Voir aussi

IMbnPinManager