RSA BSAFE Cert-C API Reference

Cert-C In-Memory Database Service Provider

The Cert-C In-Memory Database service provider stores entries in list objects in memory. The application can supply the lists used by the database, or the database can create temporary lists that are automatically destroyed when the service provider is unregistered. Databases of this type can be useful in caching or in processing lists of certificates, CRLs, private-keys, or PKCS #10 objects returned by other Cert-C functions.

To initialize or register the Cert-C Default Database service provider, call either the C_InitializeCertC or the C_RegisterService function. Both functions take SERVICE_HANDLER as a parameter. The Initialize member in SERVICE_HANDLER points to the S_InitializeMemoryDB function. The corresponding POINTER should point to a MEMORY_DB_PARAMS structure, or it should be NULL_PTR. The InitializeMemoryDB function initializes the Cert-C In-Memory Database service provider's implementation of the database functions and stores pointers to them in SERVICE_FUNCS's db member, which is a DB_FUNCS structure. Never call S_InitializeMemoryDB directly.

To use the Cert-C In-Memory Database service provider in an application, link in the certcsp library and include the imdb.h header file. The rsadbm sample program demonstrates some service provider-specific utility functions, and the imdbcert sample can be modified to use this service provider.