Export (0) Print
Expand All
Expand Minimize
This topic has not yet been rated - Rate this topic

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/valueDescription
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

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

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.