Allows the caller access to the contents of a keystore.
If the keystore is not found then a new empty store is created. The use of this method, instead of the openSigned() method, allows the caller to locate his keystore on a non-SQLite database (e.g., Postgres). The selected database (to store the keystore) can thus be on a remote machine or on the same machine as this component. However, use of this method disables the keystore wide signature feature. However, each key and its meta-data are still signned together making that association secure.
- Parameters
-
pURI | [ in ] The URI defines the underlying database to use for the keystore. Currently supported URIs include: 'sqlite3://filename', and 'postgresql8://user-name/password/hostname/hostaddr/port/database-name', where "sqlite3" and "postgresql8" are the database 'schemes'. |
- Returns
Success | P6R::eOk | |
Failure | P6R::eInvalidArg | If pPathName is NULL. |
P6R::eNotInitialized | A successful call to initialize was not made before this call. |
P6R::eLocked | Must call close() before calling open() again. |
P6R::eSignatureMismatch | The signature protecting the keystore or the data saved in the keystore has been modified. |
P6R::eSignatureMissing | The Signature protecting the keystore is missing. |