Méthode UnlockWithNumericalPassword de la classe Win32_EncryptableVolume
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 |
|---|---|
|
La méthode a réussi. |
|
BitLocker n’est pas activé sur le volume. Ajoutez un protecteur de clé pour activer BitLocker. |
|
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. |
|
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. |
|
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 |
|
Voir aussi