RSA BSAFE Cert-C API Reference

scepdb.h File Reference

This file defines structures and APIs related to the SCEP DB.

destList and proxyList are lists of ITEMs containing URL strings. These strings need not be NUL-terminated, although they may be.

For example, destList might contain the following two ITEMs:

    http://onsite.verisign.com/cgi-bin/scep.exe
    http://onsite2.verisign.com/cgi-bin/scep.exe

The protocol field in the optional proxies specified in the proxyList should match the protocol(s) used in destList.

Similarly, proxyList may contain the following:

    http://proxy1.mycompany.com:80
    http://proxy2.mycompany.com:80

One or more destinations must be specified. Proxy use is optional and zero or more may be specified. Specification of a profile is mandatory. The value must be one of the DB_SCEP_PROFILE_* values below:

Value	Description
PKI_SCEP_PROFILE_GENERIC	An unspecified, unknown, or generic profile
PKI_SCEP_PROFILE_KEON	An RSA Keon CA (KCS 5.x) profile
PKI_SCEP_PROFILE_VERISIGN	A VeriSign profile
PKI_SCEP_PROFILE_KCA6	An RSA Keon CA (KCA 6.x) profile
PKI_SCEP_PROFILE_MSCA	A Microsoft Win2000 CA profile
PKI_SCEP_PROFILE_MAX	A symbol not for use by the application

#include "transprt.h"

Go to the source code of this file.

Data Structures
struct	DB_SCEP_INIT_PARAMS
	Use the DB_SCEP_INIT_PARAMS structure to pass initialization parameters to the Cert-C SCEP Database Service Provider initialization functions. More...
struct	DB_SCEP_INIT_STRUCT
	Use the DB_SCEP_INIT_STRUCT structure to pass the Cert-C SCEP Database Service Provider initialization parameters to the DB_SCEP_INIT_PARAMS structure. More...
Functions
int	S_InitializeSCEPDB (POINTER ctx, POINTER params, SERVICE_FUNCS *funcs, POINTER *handle)
	Never call the S_InitializeSCEPDB() function directly; instead, to initialize or register the Cert-C SCEP Database Service Provider, call the C_InitializeCertC() or C_RegisterService() function. More...

---

Function Documentation

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

Never call the S_InitializeSCEPDB() function directly; instead, to initialize or register the Cert-C SCEP Database Service Provider, call the C_InitializeCertC() or C_RegisterService() function. Both functions take SERVICE_HANDLER and a POINTER to a parameters structure as parameters. SERVICE_HANDLER's Initialize parameter points to the S_InitializeSCEPDB() function, and the corresponding POINTER must point to a DB_SCEP_INIT_PARAMS structure. Cert-C uses S_InitializeSCEPDB() to initialize the Cert-C SCEP Database Service Provider functions and initialization parameters. S_InitializeSCEPDB() stores pointers to the Cert-C SCEP Database Service Provider functions in funcs's db member, which is a DB_FUNCS structure. S_InitializeSCEPDB() uses the Cert-C SCEP Database Service Provider initialization parameters in params, which points to the DB_SCEP_INIT_PARAMS structure. Parameters: ctx This input parameter points to an initialized Cert-C context handle. params This input parameter points to a type DB_SCEP_INIT_PARAMS structure; it contains the Cert-C SCEP Database Service Provider initialization parameters. 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 SCEP Database Service Provider-specific functions in SERVICE_FUNCS's db member, which is a DB_FUNCS structure. handle This output parameter points to this instance of the Cert-C SCEP Database Service Provider handle. Returns: If successful, returns 0. If not, returns a Cert-C error code.

---

RSA BSAFE^® Cert-C 2.7 API Reference