Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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