changePassword (two parameters)

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

Modifies all name/value pairs in the vault to be encrypted with a new password/salt. If the vault is locked or the new password is empty, an exception is thrown.

Syntax

- (void)changePassword:(NSString*)newPassword Salt:(NSString*)newSalt;

Parameters

newPassword – the new password.
newSalt – the new encryption salt value.

Returns

None.

Examples

Change the password for a data vault – changes the password to "newPassword". The finally clause in the try/catch block ensures that the vault ends in a secure state even if an exception occurs.

@try 
{
   [oVault unlock:@"goodPassword" Salt:@"goodSalt"];
   [oVault changePassword:@"newPassword" Salt:@"newSalt"];
}
@catch (NSException *e) {
   NSLog(@"Exception: %@",[e description]);
}
@finally 
{
   [oVault lock];
}