Share via

Méthode UnlockWithNumericalPassword de la classe Win32_EncryptableVolume

  • Article

La méthode UnlockWithNumericalPassword de la classe Win32_EncryptableVolume utilise un mot de passe numérique fourni pour accéder au contenu d’un volume de données.

La clé de chiffrement du volume doit avoir été sécurisée avec un ou plusieurs protecteurs de clé de type « Mot de passe numérique » (à l’aide de la méthode ProtectKeyWithNumericalPassword ) pour pouvoir déverrouiller le volume avec cette méthode.

Notes

Si le disque prend en charge le chiffrement matériel, cette fonction définit la bande status sur « déverrouillé »

 

Syntaxe

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

Paramètres

NumericalPassword [in]

Type : chaîne

Chaîne qui spécifie le mot de passe numérique.

Le mot de passe numérique doit contenir 48 chiffres. Ces chiffres peuvent être 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. Chaque groupe de 6 chiffres doit être divisible par 11 et doit être inférieur à 65536. 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 peuvent éventuellement être séparés par un espace ou un trait d’union. Par conséquent, « xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx » ou « xxxxxx xxxxxx xxxxxx xxxxxx » peuvent également contenir des mots de passe numériques valides.

Valeur retournée

Type : uint32

Cette méthode retourne l’un des codes suivants ou un autre code d’erreur en cas d’échec.

Si le volume est déjà déverrouillé et qu’aucune autre erreur ne se produit, cette méthode retourne 0.

Code/valeur de retour Description
S_OK
0 (0x0)
 La méthode a réussi.
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clé pour activer BitLocker.
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 Le volume n’a pas de protecteur de clé de type « Mot de passe numérique ».
Le paramètre NumericalPassword a un format valide, mais vous ne pouvez pas utiliser de mot de passe numérique pour déverrouiller le volume.
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
 Le paramètre NumericalPassword ne peut pas déverrouiller le volume.
Il existe un ou plusieurs protecteurs de clé de type « Mot de passe numérique », mais le paramètre NumericalPassword spécifié ne peut pas déverrouiller le volume.
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
 Le paramètre NumericalPassword n’a pas de format valide.

 

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