RSA BSAFE Cert-C API Reference

Stream Service Provider

Use the Cert-C Stream service provider to implement a stream to read from and write to a file using standard C file input and output functions. The IO_FUNCS structure points to all service provider functions. Any implementation of the Stream service provider is based on this structure. Click on the structure name for information on any of the members in this structure.

There is only one implementation of this service provider included in Cert-C. Other implementations can be developed, if necessary.

Implementation 1: Cert-C Stream Service Provider

To initialize or register the Cert-C Stream service provider, call either the C_InitializeCertC or the C_RegisterService function. Both functions take SERVICE_HANDLER as a parameter. The Initialize member in SERVICE_HANDLER points to the S_InitializeFileIO function and the corresponding parameter is NULL_PTR. This function initializes the Cert-C Stream service provider’s implementation of the input and output stream functions and stores pointers to them in the io member in SERVICE_FUNCS, which is an IO_FUNCS structure. S_InitializeFileIO is never called directly by the application.

To use the Cert-C Stream service provider with an application, include the fileio.h header file. The array.c sample program makes use of this service provider.