getValue

Retrieves a binary object from the vault.

Retrieves a binary object under the specified name. 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

getValue returns a binary data value, associated with the specified name, from the vault. An exception is thrown if the vault is locked when this method is called.

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 ensure 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];
}