ChangePassword (four parameters)

Changes the password for the vault. Use this method when the vault is locked

This overloaded method ensures the new password is compatible with the password policy, uses the current password to unlock the vault, and changes the password of the vault to a new password. If the current password is not valid an InvalidPassword exception is thrown. If the new password is not compatible with the password policy set in setPasswordPolicy then an IncompatiblePassword exception is thrown.

Syntax

public void ChangePassword(
	string sOldPassword,
	string sOldSalt,
	string sNewPassword,
	string sNewSalt
)

Parameters

sOldPassword – the current encryption password for this data vault. If a null value is passed, a default password is computed and used.
sOldSalt – the current encryption salt value for this data vault. If a null value is passed, a default password is computed and used.
sNewPassword – the new encryption password for this data vault. If a null value is passed, a default password is computed and used.
sNewSalt – the new encryption salt value for this data vault. This value, combined with the password, creates the actual encryption key that protects the data in the vault. This value may be an application-specific constant. If a null value is passed, a default password is computed and used.

Examples

Change the password for a data vault –

// Call changePassword with four parameters, even if the vault is locked.
// Pass null for oldSalt and oldPassword if the defaults were used.
oDataVault.ChangePassword( null, null, "password!1A", "saltD#ddg#k05%gnd[!1A" );