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

public byte[] getValue(string 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.
```
try
{
   vault.unlock("password", "salt");
   byte[] retrievedvalue = vault.getValue("testValue");
}
catch (DataVaultException e)
{
   System.out.println("Exception: " + e.toString());
}
finally
{
   vault.lock();
}
```