IsAutoUnlockKeyStored method of the Win32_EncryptableVolume class

The IsAutoUnlockKeyStored method of the Win32_EncryptableVolume class indicates whether any external keys or related information that may be used to automatically unlock data volumes exist in the currently running operating system volume.

Syntax

uint32 IsAutoUnlockKeyStored(
  [out] boolean IsAutoUnlockKeyStored
);

Parameters

IsAutoUnlockKeyStored [out]

Type: boolean

Is true if any information that can be used to automatically unlock data volumes is stored in the registry of the currently running operating system volume.

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_NOT_ACTIVATED
2150694920 (0x80310008)
BitLocker is not enabled on the volume. Add a key protector to enable BitLocker.
FVE_E_NOT_OS_VOLUME
2150694952 (0x80310028)
The method can only be run for the currently running operating system volume.

 

Remarks

Use ClearAllAutoUnlockKeys to remove all unlocking information from the currently running operating system volume.

Information used to unlock a volume is stored when EnableAutoUnlock is run for a data volume while the currently running operating system volume is running.

IsAutoUnlockKeyStored differs from IsAutoUnlockEnabled in that even if automatic unlocking is disabled for all data volumes currently connected to the computer, there may still be unlocking information associated with disconnected data volumes or data volumes that no longer exist.

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