Méthode UnlockWithCertificateThumbprint de la _ classe Win32 EncryptableVolume

La méthode UnlockWithCertificateThumbprint de la classe _ EncryptableVolume Win32 utilise l’empreinte numérique de certificat fournie pour obtenir la clé dérivée et déverrouiller le volume chiffré.

Notes

Si le disque prend en charge le chiffrement matériel, cette fonction définit l’état de la bande sur « déverrouillé ».

Syntaxe

uint32 UnlockWithCertificateThumbprint(
  [in] string CertThumbprint,
  [in] string PIN
);

Paramètres

CertThumbprint [ dans]

Type : chaîne

Une valeur d’empreinte numérique de 0 est acceptée et entraîne une recherche dans le magasin local pour le certificat approprié. Si un seul certificat BitLocker est trouvé, la recherche est réussie. Si aucun ou plusieurs certificats n’est trouvé, la méthode échoue.

Code confidentiel [ dans]

Type : chaîne

Chaîne d’identification personnelle spécifiée par l’utilisateur. Cette chaîne doit être composée d’une séquence de 4 à 20 chiffres. Cette chaîne est utilisée pour authentifier silencieusement le fournisseur de stockage de clés (KSP) lorsqu’il est utilisé avec une carte à puce.

Valeur retournée

Type : UInt32

Cette méthode retourne l’un des codes suivants, ou un autre code d’erreur en cas d’échec.

Code/valeur de retour Description
S _ OK
0 (0x0)
La méthode a réussi.
FVE _ E _ non _ activée
2150694920 (0x80310008)
BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clé pour activer BitLocker.
FVE _ E _ échec de _ l’authentification
2150694951 (0x80310027)
Le volume ne peut pas être déverrouillé à l’aide des informations fournies.
FVE _ _Protecteur E _ _ introuvable
2150694963 (0x80310033)
Le protecteur de clé fourni n’existe pas sur le volume. Vous devez entrer un autre protecteur de clé.
FVE _ Échec de l' _ _ authentification _ PRIVATEKEY
2150695060 (0x80310094)
La clé privée associée au certificat spécifié n’a pas pu être autorisée. L’autorisation de la clé privée n’a pas été fournie ou l’autorisation fournie n’était pas valide.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows 7 Entreprise, Windows 7 Édition Intégrale des [ applications de bureau uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 R2, [ applications de bureau uniquement]
Espace de noms
Racine \ de \ sécurité cimv2 \ MicrosoftVolumeEncryption
MOF
Win32 _ encryptablevolume. mof

Voir aussi

_EncryptableVolume Win32