GetConversionStatus-Methode der Win32_EncryptableVolume-Klasse
Die GetConversionStatus-Methode der Win32_EncryptableVolume-Klasse gibt die status der Verschlüsselung oder Entschlüsselung auf dem Volume an.
Syntax
uint32 GetConversionStatus(
[out] uint32 ConversionStatus,
[out] uint32 EncryptionPercentage,
[out] uint32 EncryptionFlags,
[out] uint32 WipingStatus,
[out] uint32 WipingPercentage,
[in] uint32 PrecisionFactor
);
Parameter
-
ConversionStatus [out]
-
Typ: uint32
Volumeverschlüsselung oder -entschlüsselung status. Dies kann einer der folgenden Werte sein.
Wert Bedeutung - FullyDecrypted
- 0
Bei einer Standardfestplatte (HDD) wird das Volume vollständig entschlüsselt.
Bei einer hardwareverschlüsselten Festplatte (EHDD) wird das Volume dauerhaft entsperrt.- Vollständig verschlüsselt
- 1
Bei einer Standardfestplatte (HDD) ist das Volume vollständig verschlüsselt.
Bei einer hardwareverschlüsselten Festplatte (EHDD) wird das Volume nicht dauerhaft entsperrt.- EncryptionInProgress
- 2
Das Volume ist teilweise verschlüsselt. - DecryptionInProgress
- 3
Das Volume ist teilweise verschlüsselt. - EncryptionPaused
- 4
Das Volume wurde während des Verschlüsselungsfortschritts angehalten. Das Volume ist teilweise verschlüsselt. - EntschlüsselungPausen
- 5
Das Volume wurde während des Entschlüsselungsfortschritts angehalten. Das Volume ist teilweise verschlüsselt. -
EncryptionPercentage [out]
-
Typ: uint32
Prozentsatz des verschlüsselten Volumes. Dies ist eine ganze Zahl von 0 bis einschließlich 100.
Aufgrund der Rundung von Zahlen bedeutet ein Verschlüsselungsprozentsatz von 0 oder 100 nicht unbedingt, dass der Datenträger vollständig entschlüsselt oder vollständig verschlüsselt ist. Verwenden Sie immer ConversionStatus , um zu bestimmen, ob der Datenträger tatsächlich vollständig entschlüsselt oder vollständig verschlüsselt ist.
-
EncryptionFlags [out]
-
Typ: uint32
Flags, die das Verschlüsselungsverhalten beschreiben.
Eine Kombination aus 32 Bits mit den folgenden Bits, die derzeit definiert sind.
Wert Bedeutung - 0x00000001
Führen Sie die Volumeverschlüsselung im reinen Datenverschlüsselungsmodus aus, wenn Sie einen neuen Verschlüsselungsprozess starten. Wenn die Verschlüsselung angehalten oder beendet wurde, wird die Konvertierung durch Aufrufen der Encrypt-Methode effektiv fortgesetzt, und der Wert dieses Bits wird ignoriert. Dieses Bit hat nur Auswirkungen, wenn entweder die Verschlüsselungs - oder EncryptAfterHardwareTest-Methoden die Verschlüsselung aus dem vollständig entschlüsselten Zustand, dem Status der Entschlüsselung in Bearbeitung oder dem Angehaltenen Entschlüsselungszustand starten. Wenn dieses Bit null ist, was bedeutet, dass es nicht festgelegt ist, wird beim Starten eines neuen Verschlüsselungsprozesses die Konvertierung im vollständigen Modus ausgeführt. - 0x00000002
Führen Sie die bedarfsgesteuerte Zurücksetzung des freien Speicherplatzes des Volumes durch. Das Aufrufen der Encrypt-Methode mit diesem Bitsatz ist nur zulässig, wenn das Volume derzeit nicht konvertiert oder löscht und sich in einem "verschlüsselten" Zustand befindet. - 0x00010000
Führen Sie den angeforderten Vorgang synchron aus. Der Aufruf wird blockiert, bis der angeforderte Vorgang abgeschlossen oder unterbrochen wurde. Dieses Flag wird nur mit der Encrypt-Methode unterstützt. Dieses Flag kann angegeben werden, wenn Encrypt aufgerufen wird, um die beendete oder unterbrochene Verschlüsselung oder das Löschen fortzusetzen oder wenn die Verschlüsselung oder das Löschen ausgeführt wird. Dadurch kann der Aufrufer synchron warten, bis der Prozess abgeschlossen oder unterbrochen ist. -
WipingStatus [out]
-
Typ: uint32
Freier Speicherplatz wird status. Dies kann einer der folgenden Werte sein.
Wert Bedeutung - FreeSpaceNotWiped
- 0
Der freie Speicherplatz wurde nicht gelöscht. - FreeSpaceWiped
- 1
Der freie Speicherplatz wurde zurückgesetzt. - FreeSpaceWipingInProgress
- 2
Das Löschen des freien Speicherplatzes wird derzeit ausgeführt. - FreeSpaceWipingPaused
- 3
Das Löschen des freien Speicherplatzes wurde angehalten. -
WipingPercentage [out]
-
Typ: uint32
Ein Wert von 0 bis 100, der den Prozentsatz des freien Speicherplatzes angibt, der zurückgesetzt wurde.
-
PrecisionFactor [in]
-
Typ: uint32
Ein Wert von 0 bis 4, der die Genauigkeitsebene angibt
Rückgabewert
Typ: uint32
Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn ein Fehler auftritt.
Rückgabecode/-wert | BESCHREIBUNG |
---|---|
|
Die Methode war erfolgreich. |
|
Das Volume ist gesperrt. |
Bemerkungen
MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). MOF-Dateien werden nicht als Teil des Windows SDK installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe des Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Verwaltetes Objektformat (MOF).
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista Enterprise, Windows Vista Ultimate [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
Namespace |
Root\CIMV2\Security\MicrosoftVolumeEncryption |
MOF |
|
Siehe auch