Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

DeleteKeyProtector method of the Win32_EncryptableVolume class

The DeleteKeyProtector method of the Win32_EncryptableVolume class deletes a given key protector for the volume.

If an unencrypted volume has key protectors, when DeleteKeyProtector removes the last key protector, the volume reverts to a standard NTFS file system.

If a volume has never been encrypted, deleting the key protector will revert to NTFS.

If the volume is not yet fully decrypted, use DisableKeyProtectors before removing the volume's last key protector to ensure that encrypted portions of the volume remain accessible.

Syntax


uint32 DeleteKeyProtector(
  [in]  string VolumeKeyProtectorID
);

Parameters

VolumeKeyProtectorID [in]

Type: string

A unique string identifier used to manage an encrypted volume key protector.

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_NOT_ACTIVATED
2150694920 (0x80310008)

BitLocker is not enabled on the volume. Add a key protector to enable BitLocker.

E_INVALIDARG
2147942487 (0x80070057)

The VolumeKeyProtectorID parameter does not refer to a valid key protector.

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)

This key protector cannot be deleted because it is being used to automatically unlock the volume.

Use DisableAutoUnlock to disable automatic unlocking before deleting this key protector.

 

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

 

 

Community Additions

Show:
© 2014 Microsoft