Partager via

Méthode UnlockWithExternalKey de la classe Win32_EncryptableVolume

  • Article

La méthode UnlockWithExternalKey de la classe Win32_EncryptableVolume utilise une clé externe fournie pour accéder au contenu d’un volume de données.

La clé de chiffrement du volume doit avoir été sécurisée avec un ou plusieurs protecteurs de clé de type « Clé externe » à l’aide de la méthode ProtectKeyWithExternalKey pour pouvoir déverrouiller le volume avec cette méthode.

Notes

Si le disque prend en charge le chiffrement matériel, cette fonction définit la bande status sur « déverrouillé »

 

Syntaxe

uint32 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

Paramètres

ExternalKey [in]

Type : uint8[]

Tableau d’octets qui spécifie la clé externe 256 bits utilisée pour déverrouiller le volume. Cette clé peut être obtenue en appelant la méthode GetExternalKeyFromFile .

Valeur retournée

Type : uint32

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

Si le volume est déjà déverrouillé, cette méthode retourne 0.

Code/valeur de retour Description
S_OK
0 (0x0)
 La méthode a réussi.
ERROR_NOT_FOUND
Aucune valeur donnée (0x)
 Le volume n’a pas de protecteur de clé de type « Clé externe ».
ERROR_INVALID_PASSWORD
Aucune valeur donnée (0x)
 Un ou plusieurs protecteurs de clé de type « Clé externe » existent, mais le paramètre ExternalKey spécifié ne peut pas déverrouiller le volume.
E_INVALIDARG
2147942487 (0x80070057)
 Le paramètre ExternalKey n’est pas un tableau de taille 4.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clé pour activer BitLocker.

 

Notes

Les fichiers MOF (Managed Object Format) contiennent les définitions des classes WMI (Windows Management Instrumentation). Les fichiers MOF ne sont pas installés dans le cadre du Kit de développement logiciel (SDK) Windows. Ils sont installés sur le serveur lorsque vous ajoutez le rôle associé à l’aide du Gestionnaire de serveur. Pour plus d’informations sur les fichiers MOF, consultez Managed Object Format (MOF).

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows Vista Entreprise, Windows Vista Ultimate [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows Server 2008 [applications de bureau uniquement]
Espace de noms
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

Voir aussi

Win32_EncryptableVolume