Export (0) Print
Expand All
Expand Minimize

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/valueDescription
S_OK
0 (0x0)

The method was successful.

FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)

The volume is already locked by BitLocker Drive Encryption. You must unlock the drive from Control Panel.

FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)

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

FVE_E_OVERLAPPED_UPDATE
2150694948 (0x80310024)

The control block for the encrypted volume was updated by another thread.

FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)

The specified key protector is not of the correct type.

FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)

The updated passphrase provided does not meet the minimum or maximum length requirements.

FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)

The updated passphrase does not meet the complexity requirements set by the administrator in group policy.

 

Requirements

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

Win32_encryptablevolume.mof

See also

Win32_EncryptableVolume

 

 

Community Additions

ADD
Show:
© 2014 Microsoft