Share via

Méthode GetHardwareTestStatus de la classe Win32_EncryptableVolume

  • Article

La méthode GetHardwareTestStatus de la classe Win32_EncryptableVolume fournit status informations sur un test matériel d’un volume de système d’exploitation entièrement déchiffré.

Utilisez cette méthode pour indiquer si un test matériel est en attente, ainsi que la réussite ou l’échec d’un test matériel qui s’est terminé lors du dernier redémarrage de l’ordinateur. Pour demander un test matériel, utilisez la méthode EncryptAfterHardwareTest .

Syntaxe

uint32 GetHardwareTestStatus(
  [out] uint32 TestStatus,
  [out] uint32 TestError
);

Paramètres

TestStatus [out]

Type : uint32

Spécifie si un test matériel est en attente, ainsi que la réussite de l’échec d’un test matériel qui s’est terminé lors du dernier redémarrage de l’ordinateur.

Valeur Signification
NotFailed_and_NonePending
0
 Si un test a été demandé, le test a réussi lors du dernier redémarrage de l’ordinateur et le chiffrement du volume est maintenant en cours. Pour le status de chiffrement, consultez la méthode GetConversionStatus. Sinon, aucun test n’a été exécuté lors du dernier redémarrage de l’ordinateur et aucun n’est en attente.
Échec
1
 Le chiffrement du volume n’a pas démarré. Tous les protecteurs de clé ont été supprimés.
Pour résoudre un test ayant échoué :
  • Consultez les informations du paramètre TestError .
  • Ajoutez des protecteurs de clé et utilisez à nouveau la méthode EncryptAfterHardwareTest .
En attente
2
 Un test a été demandé et s’exécutera au prochain redémarrage de l’ordinateur.

 

TestError [out]

Type : uint32

Spécifie l’erreur du dernier test matériel terminé.

Valeur Signification
0
 Aucune erreur ne s’est produite ou aucun test matériel n’a été exécuté lors du dernier redémarrage de l’ordinateur.
2150694972 (0x8031003C)
 FVE_E_KEYFILE_NOT_FOUND
Un lecteur flash USB avec un fichier de clé externe est introuvable. Si cet échec persiste, l’ordinateur ne peut pas lire les lecteurs USB lors du redémarrage. Vous ne pourrez peut-être pas utiliser des clés externes pour déverrouiller le volume du système d’exploitation lors du redémarrage.
2150694973 (0x8031003D)
 FVE_E_KEYFILE_INVALID
Le fichier de clé externe sur le lecteur flash USB a été endommagé. Essayez un autre lecteur flash USB pour stocker le fichier de clé externe.
2150694975 (0x8031003F)
 FVE_E_TPM_DISABLED
Le module de plateforme sécurisée est désactivé ou désactivé, ou à la fois désactivé et désactivé. Pour activer le module de plateforme sécurisée, utilisez le fournisseur WMI Win32_Tpm ou exécutez le composant logiciel enfichable de gestion du module TPM (Tpm.msc).
2150694977 (0x80310041)
 FVE_E_TPM_INVALID_PCR
Le module de plateforme sécurisée a détecté une modification dans les services de redémarrage du système d’exploitation dans le profil de validation de plateforme actuel. Supprimez tout CD ou DVD de démarrage de l’ordinateur. Si cet échec persiste, case activée que les dernières mises à niveau du microprogramme et du BIOS sont installées et que le module de plateforme sécurisée fonctionne correctement.
2150694979 (0x80310043)
 FVE_E_PIN_INVALID
Le code confidentiel fourni était incorrect.

 

Valeur retournée

Type : uint32

Le tableau suivant répertorie certains des codes de retour courants.

Code/valeur de retour Description
S_OK
0 (0x0)
 S_OK
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 Le volume est verrouillé.

 

Notes

Pour demander un test matériel, utilisez la méthode EncryptAfterHardwareTest .

Pour exécuter un test matériel lorsque son status est en attente, procédez comme suit :

  1. Insérez dans l’ordinateur un lecteur flash USB contenant un fichier de clé externe. Cette étape s’applique uniquement si le volume a un protecteur de clé de type « Clé externe » ou « TPM et clé de démarrage ».
  2. Redémarrez l'ordinateur. Au redémarrage de l’ordinateur, le test matériel s’exécute automatiquement.

Pour annuler le test matériel, utilisez la méthode Encrypt .

Un test réussi détermine que :

  • Le module TPM peut déverrouiller le volume s’il existe un protecteur de clé lié au module de plateforme sécurisée.
  • L’ordinateur peut lire un lecteur flash USB qui contient un fichier de clé externe au démarrage si le volume peut être déverrouillé par une clé externe (y compris une clé de démarrage).

Les résultats des tests matériels ne seront pas disponibles après toute modification de la conversion ou après le prochain redémarrage de l’ordinateur. Consultez le journal des événements système pour obtenir des informations sur les tests matériels exécutés précédemment sur l’ordinateur.

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