Partager via


Méthode UnlockWithCertificateThumbprint de la classe Win32_EncryptableVolume

La méthode UnlockWithCertificateThumbprint de la classe Win32_EncryptableVolume 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 la bande status sur « déverrouillé »

 

Syntaxe

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

Paramètres

CertThumbprint [in]

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 réussit. Si aucun certificat ou plus d’un certificat n’est trouvé, la méthode échoue.

CODE CONFIDENTIEL [in]

Type : chaîne

Chaîne d’identification personnelle spécifiée par l’utilisateur. Cette chaîne doit se composer 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’elle est utilisée avec une carte intelligente.

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_NOT_ACTIVATED
2150694920 (0x80310008)
BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clé pour activer BitLocker.
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
Le volume ne peut pas être déverrouillé à l’aide des informations fournies.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
Le protecteur de clé fourni n’existe pas sur le volume. Vous devez entrer un autre protecteur de clé.
FVE_E_PRIVATEKEY_AUTH_FAILED
2150695060 (0x80310094)
La clé privée associée au certificat spécifié n’a pas pu être autorisée. L’autorisation de clé privée n’a pas été fournie ou l’autorisation fournie n’était pas valide.

 

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 7 Entreprise, Windows 7 Édition Intégrale [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 R2 [applications de bureau uniquement]
Espace de noms
Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Voir aussi

Win32_EncryptableVolume