Méthode UnlockWithCertificateThumbprint de la classe Win32_EncryptableVolume

Article
06/13/2023

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

Share via