Méthode IMbnPinManager::GetPinState (mbnapi.h)

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.

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

Voir aussi

IMbnPinManager