Méthode IMbnPinManager::GetPinState (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 l’état actuel du code confidentiel de l’appareil.

Syntaxe

HRESULT GetPinState(
  [out] ULONG *requestID
);

Paramètres

[out] requestID

Pointeur vers l’ID de demande défini par le service Haut débit mobile pour cette demande asynchrone. La réponse contiendra le même ID de demande.

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.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Le service haut débit mobile n’est pas en cours d’exécution sur ce système.
E_HANDLE	L’interface n’est pas valide, probablement parce que l’appareil haut débit mobile a été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L’interface n’est pas valide. Très probablement, l’appareil haut débit mobile a été supprimé du système.

Notes

La méthode GetPinState lance une requête asynchrone pour l’état du code confidentiel de l’appareil. L’état du code confidentiel indique si un code confidentiel doit être entré pour qu’une opération demandée se termine. Il contient également des informations sur le type de code confidentiel attendu par un appareil et indique éventuellement le nombre de tentatives restantes pour entrer un code confidentiel valide.

Cette méthode retourne toujours l’état de code confidentiel actuel de l’appareil. Il ne met pas en cache l’état du code confidentiel au moment de la création de cet objet. Au lieu de cela, il contacte toujours l’appareil et retourne l’état actuel du code confidentiel de l’appareil.

Étant donné qu’il s’agit d’une opération asynchrone, GetPinState retourne immédiatement. Une fois l’opération terminée, le service Haut débit mobile appelle la méthode OnGetPinStateCompleted’IMbnPinManagerEvents.

Chaque fois qu’une opération retourne E_MBN_PIN_REQUIRED ou que l’état prêt signalé par l’appareil est MBN_READY_STATE_DEVICE_LOCKED, une application doit utiliser cette méthode pour interroger le type de code confidentiel requis pour déverrouiller l’appareil ou la carte SIM.

Tant que cette opération est en cours, si l’appareil haut débit mobile est supprimé du système, un appel à la méthode OnGetPinStateCompleted’IMbnPinManagerEvents n’est pas garanti.

Configuration requise

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