IMbnPin ::Unblock, méthode (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.

Débloque un code confidentiel bloqué.

Syntaxe

HRESULT Unblock(
  [in]  LPCWSTR puk,
  [in]  LPCWSTR newPin,
  [out] ULONG   *requestID
);

Paramètres

[in] puk

Valeur de clé de déblocage de mot de passe (PUK) pour ce type de code confidentiel.

[in] newPin

Nouveau code confidentiel à définir pour ce type de code confidentiel.

[out] requestID

ID de demande défini par le service Haut débit mobile pour identifier cette demande asynchrone.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
La commande s'est correctement terminée.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
Le service haut débit mobile n’est pas en cours d’exécution sur ce système.
E_HANDLE
Interface non valide. L’appareil haut débit mobile a probablement été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
Interface non valide. Très probablement, l’appareil haut débit mobile a été supprimé du système.
E_ACCESSDENIED
Cette méthode n’est pas autorisée pour appeler des privilèges de processus.

Remarques

La méthode Unblock débloque le code confidentiel pour le type de broche en entrant la puK et définit un nouveau code confidentiel. La propriété PinType de cet IMbnPin représente le type de code confidentiel en cours de modification.

S'agissant d'une opération asynchrone, Si la méthode retourne avec succès, une fois l’opération terminée, le service Haut débit mobile appelle la méthode OnUnblockComplete de IMbnPinEvents.

Chaque fois que la méthode GetPinState de IMbnPinManager obtient des résultats avec l’état du code confidentiel actuel défini sur MBN_PIN_STATE_UNBLOCK, l’application doit utiliser Unblock sur le type de code confidentiel retourné dans PinInfo.pinType transmis par la méthode OnGetPinStateComplete de IMbnPinManagerEvents.

L’appel de cette méthode nécessite des privilèges d’administrateur.

Configuration requise

Condition requise Valeur
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

IMbnPin