RSA Security logo

RSA BSAFE Cert-C
API Reference

pkixpath.h File Reference

This file defines the public interface to the PKIX based certificate path service provider.

Go to the source code to see the service provider-specific reason codes used in error and status logging.

#include "service.h"

Go to the source code of this file.

Functions

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


Function Documentation

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

This function is never called directly. To initialize or register the Cert-C Certificate Path Processing service provider, use 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_InitializePKIXPath() function, and the corresponding POINTER should be set to NULL_PTR.

Cert-C uses S_InitializePKIXPath() to initialize the Cert-C Certificate Path Processing service provider's functions. S_InitializePKIXPath() stores pointers to the Cert-C Certificate Path Processing service provider's functions in func's path member, which is a CERT_PATH_FUNCS structure.

Parameters:
ctx This input parameter is an initialized Cert-C context handle.
params This input parameter should be set to NULL_PTR.
funcs This is both an input and output parameter. On input, this parameter points to an allocated but uninitialized SERVICE_FUNCS union. On output, this parameter points to the initialized Cert-C Certificate Path Processing service-provider-specific functions in SERVICE_FUNCS's path member, which is a CERT_PATH_FUNCS structure.
handle This output parameter points to the Cert-C Certificate Path Processing service provider's handle.
Returns:
If successful, returns 0. If not, returns a Cert-C error code.



RSA BSAFE® Cert-C 2.7 API Reference