Méthode GetKeyProtectorExternalKey de la classe Win32_EncryptableVolume

  • Article

La méthode GetKeyProtectorExternalKey de la classe Win32_EncryptableVolume récupère la clé externe pour un protecteur de clé donné du type approprié.

L’identificateur du protecteur de clé doit faire référence à un logiciel de protection de clé de type « Clé externe », « TPM et code confidentiel et clé de démarrage » ou « TPM et clé de démarrage ».

Syntaxe

uint32 GetKeyProtectorExternalKey(
  [in]  string VolumeKeyProtectorID,
  [out] uint8  ExternalKey[]
);

Paramètres

VolumeKeyProtectorID [in]

Type : chaîne

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

ExternalKey [out]

Type : uint8[]

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

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é du type « Clé externe », « TPM et code confidentiel et clé de démarrage » ou « TPM et clé de démarrage ».
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clés 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 É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