NAME
RegisterDispatchTable - Provide the EMM with CSSM function
pointers (CDSA)
SYNOPSIS
# include <cssm.h>
CSSM_RETURN CSSMAPI RegisterDispatchTable
(CSSM_STATE_FUNCS_PTR CssmStateCallTable)
LIBRARY
Common Security Services Manager library (CDSA$INCSSM300_SHR.EXE)
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.
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA)
Other Help Topics
Functions: DeregisterDispatchTable