Méthode GetKeyProtectorNumericalPassword de la classe Win32_EncryptableVolume

Article
06/13/2023

La méthode GetKeyProtectorNumericalPassword de la classe Win32_EncryptableVolume récupère le mot de passe numérique 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 « Mot de passe numérique ».

Syntaxe

uint32 GetKeyProtectorNumericalPassword(
  [in]  string VolumeKeyProtectorID,
  [out] string NumericalPassword
);

Paramètres

VolumeKeyProtectorID [in]

Type : chaîne

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

NumericalPassword [out]

Type : chaîne

Chaîne qui représente le mot de passe qui peut être utilisé pour déverrouiller le volume correspondant.

Le mot de passe numérique est de 48 chiffres. Ces chiffres sont divisés en 8 groupes de 6 chiffres, le dernier chiffre de chaque groupe indiquant une valeur de somme de contrôle pour le groupe. En supposant qu’un groupe de six chiffres est étiqueté comme x1, x2, x3, x4, x5 et x6, le chiffre x6 de la somme de contrôle est calculé comme –x1+x2–x3+x4-x5 mod 11.

Les groupes de chiffres sont séparés par un trait d’union. Par conséquent, « xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx » est le format du mot de passe retourné.

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 « Password numérique ».
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

Partager via