RSA BSAFE Cert-C API Reference

imdb.h File Reference

This file defines the public interface to the Cert-C In-Memory Database service provider.

#include "service.h"

Go to the source code of this file.

Data Structures
struct	MEMORY_DB_PARAMS
	Passes initialization parameters to the Cert-C In-Memory Database service provider's initialization functions. More...
Functions
int	S_InitializeMemoryDB (POINTER ctx, POINTER params, SERVICE_FUNCS *funcs, POINTER *handle)
	Never call the S_InitializeMemoryDB() function directly; instead, to initialize or register the Cert-C In-Memory Database service provider, call the C_InitializeCertC() or C_RegisterService() function. More...

---

Function Documentation

int S_InitializeMemoryDB (  POINTER    ctx, POINTER    params, SERVICE_FUNCS *    funcs, POINTER *    handle )  ;

Never call the S_InitializeMemoryDB() function directly; instead, to initialize or register the Cert-C In-Memory Database service provider, call the C_InitializeCertC() or C_RegisterService() function. Both functions take SERVICE_HANDLER and a POINTER to a parameter's structure as parameters. SERVICE_HANDLER's Initialize parameter points to the S_InitializeMemoryDB() function. The corresponding POINTER should point to a MEMORY_DB_PARAMS structure, or be set to NULL_PTR. Cert-C uses S_InitializeMemoryDB() to initialize the Cert-C In-Memory Database service provider's functions and initialization parameters. S_InitializeMemoryDB() stores pointers to the Cert-C In-Memory Database service provider's functions in the db member of funcs, which is a DB_FUNCS structure. S_InitializeMemoryDB() uses the Cert-C database service provider's initialization parameters in params, which points to a MEMORY_DB_PARAMS structure. Parameters: ctx This input parameter points to an initialized Cert-C context handle. params This input parameter should point to a structure of type MEMORY_DB_PARAMS. The service provider uses the supplied list objects to hold database entries. The supplied list objects are not deleted when the service provider is unregistered. If this parameter is set to NULL_PTR, the service provider creates the necessary list objects. In this case, these temporary list objects are destroyed when the Cert-C In-Memory Database service provider is unregistered. funcs This is both an input and output parameter. As an input parameter, it points to an allocated but uninitialized SERVICE_FUNCS union. As an output parameter, it points to the initialized Cert-C In-Memory Database service-provider-specific functions in the db member of SERVICE_FUNCS, which is a DB_FUNCS structure. handle This output parameter points to an allocated private database structure. Returns: If successful, returns 0. If not, returns a Cert-C error code.

---

RSA BSAFE^® Cert-C 2.7 API Reference