GetConversionStatus-Methode der Win32 _ EncryptableVolume-Klasse

Die GetConversionStatus-Methode der Win32 _ EncryptableVolume-Klasse gibt den 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

Status der Volumeverschlüsselung oder -entschlüsselung. Dies kann einer der folgenden Werte sein.

Wert Bedeutung
FullyDecrypted
0
Bei einer Standard-Festplatte (HDD) ist das Volume vollständig entschlüsselt.
Für eine hardware verschlüsselte Festplatte (Hard Encrypted Hard Drive, EHDD) wird das Volume unbefristet entsperrt.
FullyEncrypted
1
Bei einer Standard-Festplatte (HDD) ist das Volume vollständig verschlüsselt.
Für eine hardware verschlüsselte Festplatte (Hard Encrypted Hard Drive, EHDD) wird das Volume nicht unbefristet 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.
DecryptionPaused
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 gibt ein Verschlüsselungsprozentsatz von 0 oder 100 nicht notwendigerweise an, dass der Datenträger vollständig entschlüsselt oder vollständig verschlüsselt ist. Verwenden Sie conversionStatus immer, 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 und den folgenden derzeit definierten Bits.

Wert Bedeutung
0x00000001
Führen Sie die Volumeverschlüsselung im 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 Bit wird ignoriert. Dieses Bit hat nur Dann Auswirkungen, wenn die Encrypt- oder EncryptAfterHardwareTest-Methode die Verschlüsselung vom vollständig entschlüsselten Zustand, der Entschlüsselung im Status "Wird durchgeführt" oder dem angehaltenen Entschlüsselungszustand aus startet. Wenn dieses Bit 0 (null) ist, was bedeutet, dass es nicht festgelegt ist, wird beim Starten eines neuen Verschlüsselungsprozesses die Konvertierung im vollständigen Modus durchgeführt.
0x00000002
Führen Sie eine bedarfsbasierte Zurücksetzung des freien Speicherplatzes auf dem Volume durch. Das Aufrufen der Encrypt-Methode mit diesem Bitsatz ist nur zulässig, wenn das Volume derzeit nicht konvertiert oder zurückf wird 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 Zurückschneiden fort aufzunehmen, oder wenn die Verschlüsselung oder das Zurückschneiden in Bearbeitung ist. Dadurch kann der Aufrufer synchron warten, bis der Prozess abgeschlossen oder unterbrochen wird.

WipingStatus [ out]

Typ: uint32

Der Status des freien Speicherplatzes wird zurückdringt. Dies kann einer der folgenden Werte sein.

Wert Bedeutung
FreeSpaceNotWiped
0
Der freie Speicherplatz wurde nicht zurückgelöscht.
FreeSpaceWiped
1
Der freie Speicherplatz wurde zurückgelöscht.
FreeSpaceWipingInProgress
2
Das Beschneiden des freien Speicherplatzes wird derzeit in Bearbeitung.
FreeSpaceWipingPaused
3
Das Beschneiden des freien Speicherplatzes wurde angehalten.

WipingPercentage [ out]

Typ: uint32

Ein Wert zwischen 0 und 100, der den Prozentsatz des freien Speicherplatzes angibt, der zurückgelöscht wurde.

PrecisionFactor [ In]

Typ: uint32

Ein Wert zwischen 0 und 4, der die Genauigkeitsstufe 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.

Hinweise

Managed Object Format -Dateien (MOF) enthalten die Definitionen für Windows WMI-Klassen (Management Instrumentation). MOF-Dateien werden nicht als Teil des Windows SDK installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe der Server-Manager. Weitere Informationen zu MOF-Dateien finden Sie unter Managed Object Format (MOF).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista Enterprise, Windows Vista [ Ultimate-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Namespace
\CimV2-Stammsicherheit \ \ MicrosoftVolumeEncryption
MOF
Win32 _ encryptablevolume.mof

Siehe auch

Win32 _ EncryptableVolume