Méthode ChangeExternalKey de la classe Win32_EncryptableVolume

Article
06/13/2023

La méthode ChangeExternalKey de la classe Win32_EncryptableVolume modifie une clé externe associée à un volume chiffré.

Syntaxe

uint32 ChangeExternalKey(
  [in]           string VolumeKeyProtectorID,
  [in, optional] uint8   NewExternalKey[],
  [out]          string NewVolumeKeyProtectorID
);

Paramètres

VolumeKeyProtectorID [in]

Type : chaîne

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

NewExternalKey [in, facultatif]

Type : uint8[]

Tableau d’octets qui spécifie la clé externe 256 bits utilisée pour déverrouiller le volume.

NewVolumeKeyProtectorID [out]

Type : chaîne

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

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.
E_INVALIDARG 2147942487 (0x80070057)	Le paramètre NewExternalKey n’est pas un tableau de taille 32.
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é pour activer BitLocker.
FVE_E_BOOTABLE_CDDVD 2150694960 (0x80310030)	Un CD/DVD démarrable se trouve sur cet ordinateur. Supprimez le CD/DVD et redémarrez l’ordinateur.
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 « Mot de passe numérique » ou « Clé externe ». Utilisez la méthode ProtectKeyWithNumericalPassword ou ProtectKeyWithExternalKey pour créer un protecteur de clé du type approprié.

Notes

Cette méthode peut être utilisée pour modifier la clé externe de n’importe quel protecteur de clé qui utilise une clé externe.

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

Partager via