changePassword

Changes the password for the vault.

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 withSalt:(NSString*)newSalt;

Parameters

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

Examples

Change the Password for a Data Vault – Changes the password to "newPassword". The finally clause in the try/catch block ensure that the vault ends in a secure state even if an exception occurs.

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