ChangePassphrase method of the Win32_EncryptableVolume class
The ChangePassphrase method of the Win32_EncryptableVolume class uses the new passphrase to obtain a new derived key. After the derived key is calculated, the new derived key is used to secure the encrypted volume's master key.
Syntax
uint32 ChangePassphrase(
[in] string VolumeKeyProtectorID,
[in] string NewPassphrase,
[out] string NewProtectorID
);
Parameters
-
VolumeKeyProtectorID [in]
-
Type: string
A unique string identifier that is used to manage an encrypted volume key protector.
-
NewPassphrase [in]
-
Type: string
An updated string that specifies the passphrase.
-
NewProtectorID [out]
-
Type: string
An updated 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/value | Description |
|---|---|
|
The method was successful. |
|
The volume is already locked by BitLocker Drive Encryption. You must unlock the drive from Control Panel. |
|
BitLocker is not enabled on the volume. Add a key protector to enable BitLocker. |
|
The control block for the encrypted volume was updated by another thread. |
|
The specified key protector is not of the correct type. |
|
The updated passphrase provided does not meet the minimum or maximum length requirements. |
|
The updated passphrase does not meet the complexity requirements set by the administrator in group policy. |
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