Data Vault API References

The data vault is a secure storage area provided by the SUP 2.1 SDK client libraries to store sensitive data such as usernames, passwords, authentication certificates within the application. Access to the data vault is protected by two levels of passwords and unique salts.

Creating a Vault
Creates an instance of a vault with a set of attributes.
Opening an Existing Vault
Returns the SUPDataVault singleton instance, tied to a particular vault. If the vault does not exist or has been deleted, this method throws an exception.
Deleting a Vault
Delete the storage for this instance from the persistent storage. Once a vault is deleted, all current instance references become invalid.
Locking a Vault
Lock a vault to avoid it from being used. If the vault is locked, this API will have no effect.
Unlocking a Vault
Unlock a vault for use by an application.
Setting a Binary Value
Store a value in the vault. To remove a value, provide 'null' as the second parameter.
Retrieving a Binary Value
Retrieve a value set from the vault.
Setting the Retry Limit Value for a Vault
Set the maximum number of consecutive failed attempts to unlock the vault.
Setting the Lock Timeout Value for a Vault
Set the time until which the vault remains in an unlocked state. Once this time is lapsed, the vault reverts to the locked state.

Parent topic: Developing Applications in the BlackBerry Development Environment

Created November 3, 2011. To comment on this topic, go to: DocCommentXchange.