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
S_OK
0 (0x0)
Die Methode war erfolgreich.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
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
Win32_encryptablevolume.mof

Siehe auch

Win32_EncryptableVolume