NAME

RegisterDispatchTable − Provide the EMM with CSSM function pointers (CDSA)

SYNOPSIS

# include <cdsa/cssm.h>

CSSM_RETURN CSSMAPI RegisterDispatchTable
(CSSM_STATE_FUNCS_PTR CssmStateCallTable)

LIBRARY

Common Security Services Manager library (libcssm.so)

PARAMETERS

CssmStateCallTable (input)
A table of function pointers for the set of CSSM-defined functions the elective module manager can use to query and control the state of an attach-session between an application and a service provider managed by the module manager.

DESCRIPTION

This EMM-defined function is invoked by CSSM once for each CSSM_ModuleAttach(), operation requesting a service provider of the type managed by the EMM. CSSM uses this function to provide the EMM with a set of CSSM function pointers. The EMM invokes these functions at anytime during the life cycle of the attach-session to obtain information about the current state and to modify the current state of the attach session. 

When the attach-session is terminated, CSSM informs the module manager by invoking the EMM function DeregisterDispatchTable().  The corresponding set of CSSM state functions become invalid at that time. 

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particular error condition. The value CSSM_OK indicates success. All other values represent an error condition. 

ERRORS

Errors are described in the CDSA technical standard.  See CDSA_intro(3). 

SEE ALSO

Books

Intel CDSA Application Developer’s Guide (see CDSA_intro(3))

Reference Pages

Functions: DeregisterDispatchTable(3)