DeleteKeyProtectors-Methode der Win32_EncryptableVolume-Klasse

Die DeleteKeyProtectors-Methode der Win32_EncryptableVolume-Klasse löscht alle Schlüsselschutzvorrichtungen für das Volume.

Wenn ein unverschlüsseltes Volume über Schlüsselschutzvorrichtungen verfügt, wird das Volume bei erfolgreicher Ausführung von DeleteKeyProtectors auf ein NTFS-Standarddateisystem zurückgesetzt.

Wenn das Volume noch nicht vollständig entschlüsselt wurde, verwenden Sie DisableKeyProtectors , bevor Sie DeleteKeyProtectors ausführen, um sicherzustellen, dass verschlüsselte Teile des Volumes zugänglich bleiben.

Syntax

uint32 DeleteKeyProtectors();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Typ: uint32

Diese Methode gibt einen der folgenden Codes oder einen anderen Fehlercode zurück, wenn sie fehlschlägt.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0 (0x0)
Die Methode war erfolgreich.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
Das Volume ist gesperrt.
FVE_E_KEY_REQUIRED
2150694941 (0x8031001D)
Die letzte Schlüsselschutzvorrichtung für ein teilweise oder vollständig verschlüsseltes Volume kann nicht entfernt werden, wenn Schlüsselschutzvorrichtungen aktiviert sind. Verwenden Sie DisableKeyProtectors , bevor Sie diese letzte Schlüsselschutzvorrichtung entfernen, um sicherzustellen, dass verschlüsselte Teile des Volumes weiterhin zugänglich bleiben.
FVE_E_VOLUME_BOUND_ALREADY
2150694943 (0x8031001F)
Schlüsselschutzvorrichtungen können nicht gelöscht werden, da eine von ihnen zum automatischen Entsperren des Volumes verwendet wird.
Verwenden Sie DisableAutoUnlock , um die automatische Entsperrung zu deaktivieren, bevor Sie diese Methode ausführen.

 

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 der Server-Manager hinzufügen. 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 [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