Méthode GetKeyPackage de la classe Win32_EncryptableVolume

Article
06/13/2023

La méthode GetKeyPackage de la classe Win32_EncryptableVolume exporte des informations qui peuvent aider à récupérer des données chiffrées lorsque le lecteur est gravement endommagé et qu’il n’existe aucun fichier de sauvegarde de données.

Les informations exportées se composent de la clé de chiffrement du volume sécurisée par un protecteur de clé de type « Mot de passe numérique » ou « Clé externe ». Pour utiliser ce package, vous devez également enregistrer le mot de passe numérique ou la clé externe correspondant.

Important

Si vous choisissez d’exporter un package de clés, veillez à conserver ces informations dans un emplacement bien protégé. Ne transportez pas ces informations avec votre ordinateur. Si ce package de clé est perdu ou volé, vous devez déchiffrer le volume et le déchiffrer à nouveau à l’aide d’une nouvelle clé.

En cas de défaillance d’un lecteur, l’outil de réparation BitLocker existe pour aider à récupérer les données disponibles. Pour plus d’informations sur la façon dont cet outil peut utiliser le package de clés, consultez Comment utiliser l’outil de réparation BitLocker pour vous aider à récupérer des données à partir d’un volume chiffré dans Windows Vista.

Syntaxe

uint32 GetKeyPackage(
  [in]  string VolumeKeyProtectorID,
  [out] uint8  KeyPackage[]
);

Paramètres

VolumeKeyProtectorID [in]

Type : chaîne

Identificateur de chaîne unique utilisé pour gérer un protecteur de clé de volume chiffré. Pour exporter un package de clés, vous devez utiliser un logiciel de protection de clé de type « Mot de passe numérique » ou « Clé externe ».

KeyPackage[] [out]

Type : uint8

Flux d’octets qui contient la clé de chiffrement d’un volume, sécurisé par le protecteur de clé spécifié.

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_LOCKED_VOLUME 2150694912 (0x80310000)	Le volume est verrouillé.
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clés pour activer BitLocker.
FVE_E_PROTECTOR_NOT_FOUND 2150694963 (0x80310033)	Le protecteur de clé fourni n’existe pas sur le volume.
FVE_E_INVALID_PROTECTOR_TYPE 2150694970 (0x8031003A)	Le paramètre VolumeKeyProtectorID ne fait pas référence à un protecteur de clé de type « Password numérique » ou « External Key ». Utilisez la méthode ProtectKeyWithNumericalPassword ou ProtectKeyWithExternalKey pour créer un protecteur de clé du type approprié.

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 Édition intégrale [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

Share via