RSA Security logo

RSA BSAFE Cert-C
API Reference

fileio.h File Reference

This file defines the public interface to the file-based I/O service provider.

#include "service.h"

Go to the source code of this file.

Functions

int S_InitializeFileIO (CERTC_CTX ctx, POINTER params, SERVICE_FUNCS *funcs, POINTER *handle)
 Never call the S_InitializeFileIO() function directly. More...


Function Documentation

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

Never call the S_InitializeFileIO() function directly. Instead, to initialize or register the Cert-C Stream 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_InitializeFileIO() function, and the corresponding POINTER should be set to NULL_PTR.

Cert-C uses S_InitializeFileIO() to initialize the Cert-C Stream service provider's functions. S_InitializeFileIO() stores pointers to the Cert-C Stream service provider's functions in func's io member, which is an IO_FUNCS structure.

Parameters:
ctx This input parameter points to 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. 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 Stream service provider-specific functions in the io member of SERVICES_FUNCS.
handle This function has no global state, so the handle parameter is set to NULL_PTR.
Returns:
If successful, returns 0. If not, returns a Cert-C error code.



RSA BSAFE® Cert-C 2.7 API Reference