Méthode SaveExternalKeyToFile de la classe Win32_EncryptableVolume

Article
06/13/2023

La méthode SaveExternalKeyToFile de la classe Win32_EncryptableVolume écrit la clé externe associée au protecteur de clé de volume spécifié dans un fichier système, masqué, en lecture seule dans le dossier spécifié.

Cette méthode s’applique uniquement aux protecteurs de clés de type « Clé externe » ou « TPM et clé de démarrage ».

Syntaxe

uint32 SaveExternalKeyToFile(
  [in] string VolumeKeyProtectorID,
  [in] string Path
);

Paramètres

VolumeKeyProtectorID [in]

Type : chaîne

Identificateur de chaîne unique utilisé pour gérer un protecteur de clé de volume chiffré.

Chemin d’accès [in]

Type : chaîne

Chaîne qui contient l’emplacement du volume ou du dossier où la clé externe associée au protecteur de clé spécifié doit être enregistrée. Ce chemin d’accès n’inclut pas le nom du fichier, qui est interne et peut changer de version en version. Utilisez GetExternalKeyFileName pour obtenir le nom du fichier.

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é.
E_INVALIDARG 2147942487 (0x80070057)	Le paramètre VolumeKeyProtectorID ne fait pas référence à un protecteur de clé de type « Clé externe » ou « TPM et clé de démarrage ».
ERROR_PATH_NOT_FOUND 2147942403 (0x80070003)	Le paramètre Path ne fait pas référence à un emplacement valide. Vérifiez que le nom de fichier n’est pas inclus dans le paramètre Path .
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

Partager via