RSA Security logo

RSA BSAFE Cert-C
API Reference

DEFAULT_DB_PARAMS Struct Reference

Passes initialization parameters to the Cert-C Default Database service provider initialization functions.

When you use C_InitializeCertC() to register the Cert- C Default Database service provider, the corresponding handlerParams should point to a DEFAULT_DB_PARAMS structure. Or, if you use C_RegisterService() to register the Cert-C Default Database service provider, the corresponding params should point to a DEFAULT_DB_PARAMS structure.

Data Fields
path Points to the file system path (or directory) where the database files are stored. If path is set to (char *)NUL_PTR, the current working directory is assumed. This value must use platform-specific delimiters. On Windows NT, the path should use a back-slash (</em>), rather than the forward-slash (/), commonly accepted by the standard C file functions. For example, on Windows NT, the path might looks something like this: c:\certc\mydatabase.
name Points to the database name. name should be a NUL-terminated character string containing 1 to 32 characters. If this parameter is set to (char *)NUL_PTR, the database name default is assumed. Database names are case-sensitive.
password The password (or pass-phrase) used to encrypt and decrypt private-key records. If the password length is set to zero, a zero-length, empty password is used. Otherwise, the password length should be set to the number of bytes of password data. password can contain any byte values; values are not limited to printable characters. For private-key retrieval to succeed, password data must be identical to the password used when the private-key was inserted.

#include <rsadb.h>

00073 typedef struct {
00074   char *path;           /* path to database          */
00075   char *name;           /* database name             */
00076   ITEM  password;       /* password for private keys */
00077 } DEFAULT_DB_PARAMS;

The documentation for this struct was generated from the following file:


RSA BSAFE® Cert-C 2.7 API Reference