RSA BSAFE Cert-C API Reference

textsurr.h File Reference

This file defines the public interface to the text-output surrender service provider.

#include "service.h"

Go to the source code of this file.

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

---

Function Documentation

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

Never call the S_InitializeTextSurrender() function directly. Instead, to initialize or register the Cert-C Text Surrender Service Provider, call the C_InitializeCertC() or C_RegisterService() function. Both functions take SERVICE_HANDLER as a parameter; SERVICE_HANDLER's Initialize parameter points to the S_InitializeTextSurrender() function. Cert-C uses S_InitializeTextSurrender() to initialize the Cert-C Text Surrender Service Provider functions. S_InitializeTextSurrender() stores pointers to the Cert-C Text Surrender Service Provider functions in func's surrender member, which is a SURRENDER_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 Text Surrender Service Provider-specific functions in SERVICE_FUNCS's surrender member. handle This output parameter contains the service-provider handle for this instance of the Cert-C Text Surrender Service Provider. Returns: If successful, returns 0. If not, returns a Cert-C error code.

---

RSA BSAFE^® Cert-C 2.7 API Reference