createVault

Creates a new secure store.

Creates a vault. A unique name is assigned, and after creation, the vault is referenced and accessed by that name. This method also assigns a password and salt value to the vault. If a vault already exists with the same name, this method throws an exception. When created, the vault is in the unlocked state.

Syntax

+ (SUPDataVault*)createVault:(NSString*)name withPassword:(NSString*)password withSalt:(NSString*)salt;

Parameters

name – The vault name.
password – The password.
salt – The encryption salt value.

Returns

createVault creates a SUPDataVault instance.

If a vault already exists with the same name, a SUPDataVaultException is thrown this with the reason kDataVaultExceptionReasonAlreadyExists.

Examples

Create a Data Vault – Creates a new data vault called myVault.

@try
{
    if(![SUPDataVault vaultExists:@"myVault"])
    {
        oVault = [SUPDataVault createVault:@"myVault" 
                               withPassword:@"goodPassword" 
                               withSalt:@"goodSalt"];
    }
}
@catch ( NSException *e )
{
    NSLog(@"SUPDataVaultException: %@",[e description]);
}