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

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 GetPinStated’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 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 GetPinStated’IMbnPinManager.
Une fois l’opération terminée, pinInfo contient des informations sur le code confidentiel attendu par l’appareil.

Configuration requise

Voir aussi

IMbnPinManagerEvents