UnlockWithPassphrase method of the Win32_EncryptableVolume class
The UnlockWithPassphrase method of the Win32_EncryptableVolume class uses the passphrase to obtain the derived key. After the derived key is calculated, the derived key is used to unlock the encrypted volume's master key.
Note
If the disc supports hardware encryption this function sets the band status to "unlocked""
Syntax
uint32 UnlockWithPassphrase(
[in] string Passphrase
);
Parameters
-
Passphrase [in]
-
Type: string
A string that specifies the passphrase.
Return value
Type: uint32
This method returns one of the following codes or another error code if it fails.
| Return code/value | Description |
|---|---|
|
The method was successful. |
|
BitLocker is not enabled on the volume. Add a key protector to enable BitLocker. |
|
The group policy setting that requires FIPS compliance prevented the passphrase from being generated or used. |
|
The passphrase provided does not meet the minimum or maximum length requirements. |
|
The passphrase does not meet the complexity requirements set by the administrator in group policy. |
|
The volume cannot be unlocked with the provided information. |
|
The provided key protector does not exist on the volume. You must enter another key protector. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows 7 Enterprise, Windows 7 Ultimate [desktop apps only] |
| Minimum supported server |
Windows Server 2008 R2 [desktop apps only] |
| Namespace |
Root\CIMV2\Security\MicrosoftVolumeEncryption |
| MOF |
|
See also