Méthode IMbnPinEvents::OnEnableComplete (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.
Méthode de notification appelée par le service haut débit mobile pour indiquer qu’une opération d’activation du code confidentiel est terminée.
Syntaxe
HRESULT OnEnableComplete(
[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 de 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 requête défini par le service Haut débit mobile pour identifier la demande d’activation 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 | Signification |
|---|---|
|
L'opération a réussi. |
|
L’appareil ne prend pas en charge cette opération. |
|
L'opération n'a pas pu être terminée. |
|
Un code confidentiel est requis pour que l’opération se termine. L’application appelante peut appeler la méthode GetPinStated’IMbnPinManager pour découvrir le type de code confidentiel attendu. |
|
Il n’y a pas de carte SIM dans l’appareil. |
|
Il y a une carte SIM incorrecte dans l’appareil. |
|
Une tentative d’utilisation du code confidentiel a échoué. |
Valeur retournée
Cette méthode doit retourner S_OK.
Notes
La méthode OnEnableComplete est appelée par le service Haut débit mobile pour signaler l’achèvement status d’une opération d’activation du code confidentiel initialisée par un appel à la méthode Enabled’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 les tentatives répétées avec un code confidentiel incorrect entraînent la conversion de tentativesRemaining à la valeur 0, l’application peut appeler la méthode GetPinStated’IMbnPinManager pour obtenir le type de code confidentiel requis.
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 |