RSA Security logo

RSA BSAFE Cert-C
API Reference

ocsp.h File Reference

This file defines the public interface to a certificate-revocation status provider based on OCSP.

#include "service.h"
#include "transprt.h"

Go to the source code of this file.

Data Structures

struct  OCSP_RESPONDER
 Details how an instance of the Cert-C OCSP Revocation Status service provider should choose and communicate with a given OCSP responder. More...

struct  OCSP_SIGNER
 Details how the Cert-C OCSP Revocation Status service provider should sign requests for the associated OCSP responder. More...

struct  REVOKE_OCSP_INIT_PARAMS
 Passes initialization parameters to the Cert-C OCSP Revocation Status service provider's initialization functions. More...

struct  REVOKE_OCSP_INIT_STRUCT
 Stores initialization parameters for the Cert-C OCSP Revocation Status service provider, in the format that REVOKE_OCSP_INIT_PARAMS's initChoice member specifies. More...


Functions

int S_InitializeOCSP (CERTC_CTX ctx, POINTER params, SERVICE_FUNCS *funcs, POINTER *handle)
 This function is never called directly. More...


Function Documentation

int S_InitializeOCSP CERTC_CTX    ctx,
POINTER    params,
SERVICE_FUNCS   funcs,
POINTER *    handle
;
 

This function is never called directly. To initialize or register the Cert-C OCSP Revocation Status service provider, call the C_InitializeCertC() or C_RegisterService() function. Both functions take SERVICE_HANDLER and a POINTER to a parameters structure as parameters. The Initialize parameter in SERVICE_HANDLER points to the S_InitializeOCSP() function, and the corresponding POINTER should point to a REVOKE_OCSP_INIT_PARAMS structure.

Cert-C uses S_InitializeOCSP() to initialize the Cert-C OCSP Revocation Status service provider functions. S_InitializeOCSP() stores pointers to the Cert-C OCSP Revocation Status service provider functions in func's revoke member, which is a cert_revoke_funcs structure. S_InitializeOCSP() uses the Cert-C OCSP Revocation Status service provider initialization parameters in params, which points to a REVOKE_OCSP_INIT_PARAMS structure.

Parameters:
ctx This input parameter points to an initialized Cert-C context.
params This input parameter points to a REVOKE_OCSP_INIT_PARAMS data structure.
funcs This is both an input and an output parameter. As an input parameter, it points to an allocated but uninitialized CERT_SERVICE_FUNCS union. As an output parameter, it contains the cert_revoke_funcs function pointers for the Cert-C OCSP Revocation Status service provider.
handle This output parameter points to the handle for this instance of the Cert-C OCSP Revocation Status service provider.
Returns:
If successful, returns 0. If not, returns a Cert-C error code.



RSA BSAFE® Cert-C 2.7 API Reference