IMbnPin ::Unblock, méthode (mbnapi.h)

Article
02/28/2024

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

Partager via