getValue

Retrieves a binary object from the vault.

An exception is thrown if the vault is locked when this method is called.

Syntax

- (NSData*)getValue:(NSString*)name;

Parameters

name – the name associated with the binary object to be retrieved.

Returns

Returns a binary data value, associated with the specified name, from the vault.

Examples

Get a binary value – unlocks the vault and retrieves a binary value associated with the name "testValue" in the vault. The finally clause in the try/catch block ensures that the vault ends in a secure state even if an exception occurs.

NSData *retrievedvalue = nil;
    
@try {
   [oVault unlock:@"goodPassword" withSalt:@"goodSalt"];
   retrievedvalue = [oVault getValue:@"testValue"];
}
@catch (NSException *e) {
   NSLog(@"Exception: %@",[e description]);
}
@finally {
   [oVault lock];
}