RegisterDispatchTable(3)RegisterDispatchTable(3)NAMERegisterDispatchTable - Provide the EMM with CSSM function pointers
(CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
CSSM_RETURN CSSMAPI RegisterDispatchTable (CSSM_STATE_FUNCS_PTR Cssm‐
StateCallTable)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
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_Mod‐
uleAttach(), operation requesting a service provider of the type man‐
aged 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 ses‐
sion.
When the attach-session is terminated, CSSM informs the module manager
by invoking the EMM function DeregisterDispatchTable(). The corre‐
sponding 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 repre‐
sent 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)RegisterDispatchTable(3)