Partager via

Méthode GetConversionStatus de la classe Win32_EncryptableVolume

  • Article

La méthode GetConversionStatus de la classe Win32_EncryptableVolume indique la status du chiffrement ou du déchiffrement sur le volume.

Syntaxe

uint32 GetConversionStatus(
  [out] uint32 ConversionStatus,
  [out] uint32 EncryptionPercentage,
  [out] uint32 EncryptionFlags,
  [out] uint32 WipingStatus,
  [out] uint32 WipingPercentage,
  [in]  uint32 PrecisionFactor
);

Paramètres

ConversionStatus [out]

Type : uint32

Chiffrement ou déchiffrement de volume status. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
FullyDecrypted
0
 Pour un disque dur standard (HDD), le volume est entièrement déchiffré.
Pour un disque dur chiffré matériel (EHDD), le volume est perpétuellement déverrouillé.
FullyEncrypted
1
 Pour un disque dur standard (HDD), le volume est entièrement chiffré.
Pour un disque dur chiffré matériel (EHDD), le volume n’est pas perpétuellement déverrouillé.
EncryptionInProgress
2
 Le volume est partiellement chiffré.
DecryptionInProgress
3
 Le volume est partiellement chiffré.
EncryptionPaused
4
 Le volume a été suspendu pendant la progression du chiffrement. Le volume est partiellement chiffré.
DecryptionPaused
5
 Le volume a été suspendu pendant la progression du déchiffrement. Le volume est partiellement chiffré.

 

EncryptionPercentage [out]

Type : uint32

Pourcentage du volume chiffré. Il s’agit d’un entier compris entre 0 et 100 inclus.

En raison de l’arrondi des nombres, un pourcentage de chiffrement de 0 ou 100 n’indique pas nécessairement que le disque est entièrement déchiffré ou entièrement chiffré. Utilisez toujours ConversionStatus pour déterminer si le disque est entièrement déchiffré ou entièrement chiffré.

EncryptionFlags [out]

Type : uint32

Indicateurs qui décrivent le comportement de chiffrement.

Combinaison de 32 bits avec les bits suivants actuellement définis.

Valeur Signification
0x00000001
 Effectuez le chiffrement de volume en mode de chiffrement données uniquement lors du démarrage d’un nouveau processus de chiffrement. Si le chiffrement a été suspendu ou arrêté, l’appel de la méthode Encrypt reprend la conversion et la valeur de ce bit est ignorée. Ce bit n’a effet que lorsque les méthodes Encrypt ou EncryptAfterHardwareTest démarrent le chiffrement à partir de l’état entièrement déchiffré, de l’état de déchiffrement en cours ou de l’état de déchiffrement suspendu. Si ce bit est égal à zéro, ce qui signifie qu’il n’est pas défini, lors du démarrage d’un nouveau processus de chiffrement, la conversion en mode complet est effectuée.
0x00000002
 Effectuez une réinitialisation à la demande de l’espace libre du volume. L’appel de la méthode Encrypt avec ce jeu de bits n’est autorisé que lorsque le volume n’est pas en cours de conversion ou d’réinitialisation et qu’il est dans un état « chiffré ».
0x00010000
 Effectuez l’opération demandée de manière synchrone. L’appel se bloque jusqu’à ce que l’opération demandée soit terminée ou interrompue. Cet indicateur est uniquement pris en charge avec la méthode Encrypt . Cet indicateur peut être spécifié lorsque Encrypt est appelé pour reprendre le chiffrement arrêté ou interrompu, ou lorsque le chiffrement ou l’réinitialisation est en cours. Cela permet à l’appelant de reprendre de façon synchrone en attendant que le processus soit terminé ou interrompu.

 

WipingStatus [out]

Type : uint32

Espace libre réinitialisation status. Il peut s’agir de l’une des valeurs suivantes.

Valeur Signification
FreeSpaceNotWiped
0
 L’espace libre n’a pas été effacé.
FreeSpaceWiped
1
 L’espace libre a été effacé.
FreeSpaceWipingInProgress
2
 Le réinitialisation de l’espace libre est en cours.
FreeSpaceWipingPaused
3
 Le réinitialisation de l’espace libre a été suspendue.

 

WipingPercentage [out]

Type : uint32

Valeur comprise entre 0 et 100 qui spécifie le pourcentage d’espace libre qui a été effacé.

PrecisionFactor [in]

Type : uint32

Valeur comprise entre 0 et 4 qui spécifie le niveau de précision

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é.

 

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