IMbnPinManagerEvents::OnGetPinStateComplete, méthode (mbnapi.h)

Article
08/24/2023

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.

Méthode de notification appelée par le service Haut débit mobile pour indiquer l’achèvement d’une opération asynchrone déclenchée par un appel à la méthode GetPinState d’IMbnPinManager.

Syntaxe

HRESULT OnGetPinStateComplete(
  [in] IMbnPinManager *pinManager,
  [in] MBN_PIN_INFO   pinInfo,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Paramètres

[in] pinManager

Pointeur vers une interface IMbnPinManager qui représente l’appareil haut débit mobile pour lequel l’opération a été effectuée.

[in] pinInfo

Structure MBN_PIN_INFO qui contient les informations de code confidentiel de l’appareil.

Si pinInfo.pinState est défini sur MBN_PIN_STATE_NONE aucun code confidentiel n’est censé être entré par l’appareil.

Si pinInfo.pinState a la valeur MBN_PIN_STATE_ENTER l’appareil s’attend à ce qu’un code confidentiel soit entré et pinInfo.pinType représente le type de code confidentiel attendu par l’appareil.

Si pinInfo.pinState est défini sur MBN_PIN_STATE_UNBLOCK l’appareil est bloqué et une opération de déblocage de code confidentiel doit être tentée pour débloquer l’appareil. Dans ce cas, pinInfo.pinType représente le type de code confidentiel sur lequel l’opération de déblocage doit être effectuée.

Si pinInfo.pinState est défini sur MBN_PIN_STATE_ENTER ou MBN_PIN_STATE_UNBLOCK, pinInfo.attemptsRemaining contient le nombre de tentatives restantes pour entrer un code confidentiel ou une clé de déblocage (PUK) valide. Si le nombre de tentatives restantes est inconnu, pinInfo.attemptsRemaining est défini sur MBN_ATTEMPTS_REMAINING_UNKNOWN.

[in] requestID

ID de demande attribué par le service Haut débit mobile pour identifier cette opération.

[in] status

Status d’achèvement de l’opération.

Une application appelante peut s’attendre à l’une des valeurs suivantes.

Valeur	Signification
S_OK	L'opération a réussi.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’appareil ne prend pas en charge les opérations de code confidentiel.
E_MBN_SIM_NOT_INSERTED	L’opération n’a pas pu se terminer, car une carte SIM n’est pas dans l’appareil.
E_MBN_BAD_SIM	L’opération n’a pas pu se terminer, car une carte SIM incorrecte a été détectée sur l’appareil.

Valeur retournée

Cette méthode doit retourner S_OK.

Notes

Cette méthode est appelée par le service Haut débit mobile pour notifier une application de l’achèvement d’une opération asynchrone déclenchée par un appel à la méthode GetPinState d’IMbnPinManager.
Une fois l’opération terminée, pinInfo contient des informations sur le code confidentiel attendu par l’appareil.

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

IMbnPinManagerEvents

Partager via