Méthode IMbnPinEvents::OnUnblockComplete (mbnapi.h)

Méthode de notification appelée par le service haut débit mobile pour indiquer qu’une opération de déblocage de code confidentiel est terminée

Syntaxe

HRESULT OnUnblockComplete(
  [in] IMbnPin      *Pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Paramètres

[in] Pin

Interface IMbnPin qui représente le type de code confidentiel.

[in] pinInfo

Pointeur vers une structure MBN_PIN_INFO qui contient des informations sur les tentatives restantes, en cas d’opérations d’échec. Le contenu de pinInfo n’est significatif que lorsque status est E_MBN_FAILURE.

[in] requestID

ID de demande défini par le service haut débit mobile pour identifier la demande de déblocage du code confidentiel.

[in] status

Un code status qui indique le résultat 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

La méthode OnUnblockComplete est appelée par le service Haut débit mobile pour signaler l’achèvement status d’une opération de déblocage de code confidentiel initialisée par un appel à la méthode Unblock de IMbnPin.

Le contenu de pinInfo n’est significatif que lorsque status est E_MBN_FAILURE. Le membre pinState doit être ignoré et le champ pinType est défini sur le type de code confidentiel de l’interface IMbnPin actuelle. Cette structure contient les tentatives restantes pour entrer un code confidentiel valide.

Par exemple, si le code confidentiel passé pour modifier un type de code confidentiel est incorrect, l’opération échoue avec un code status de E_MBN_FAILURE. Dans ce cas, pinInfo.attemptsRemaining spécifie le nombre de tentatives restantes pour réessayer cette opération. Si des tentatives répétées avec le code confidentiel incorrect entraînent la valeur 0 tentativesRemaining , l’application peut appeler la méthode GetPinState de IMbnPinManager pour obtenir le type de code confidentiel requis.

Si le déblocage de l’appareil ne parvient pas et si le blocage de puK est d’une broche MBN_PIN_TYPE_PIN1 , l’état prêt de l’appareil passe également à MBN_READY_STATE_BAD_SIM. L’application appelante sera avertie de la modification de ReadyState via le membre OnReadyStateChange de IMbnInterfaceEvents.

Configuration requise

Voir aussi

IMbnPinEvents