DeleteKeyProtectors method of the Win32_EncryptableVolume class

The DeleteKeyProtectors method of the Win32_EncryptableVolume class deletes all key protectors for the volume.

If an unencrypted volume has key protectors, when DeleteKeyProtectors is run successfully the volume reverts to a standard NTFS file system.

If the volume is not yet fully decrypted, use DisableKeyProtectors before running DeleteKeyProtectors to ensure that encrypted portions of the volume remain accessible.

Syntax

uint32 DeleteKeyProtectors();

Parameters

This method has no parameters.

Return value

Type: uint32

This method returns one of the following codes or another error code if it fails.

Return code/value Description
S_OK
0 (0x0)
The method was successful.
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
The volume is locked.
FVE_E_KEY_REQUIRED
2150694941 (0x8031001D)
The last key protector for a partially or fully encrypted volume cannot be removed if key protectors are enabled. Use DisableKeyProtectors before removing this last key protector to ensure that encrypted portions of the volume remain accessible.
FVE_E_VOLUME_BOUND_ALREADY
2150694943 (0x8031001F)
Key protectors cannot be deleted because one of them is being used to automatically unlock the volume.
Use DisableAutoUnlock to disable automatic unlocking before running this method.

 

Remarks

Managed Object Format (MOF) files contain the definitions for Windows Management Instrumentation (WMI) classes. MOF files are not installed as part of the Windows SDK. They are installed on the server when you add the associated role by using the Server Manager. For more information about MOF files, see Managed Object Format (MOF).

Requirements

Requirement Value
Minimum supported client
Windows Vista Enterprise, Windows Vista Ultimate [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Namespace
Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

See also

Win32_EncryptableVolume