NAME
RegisterDispatchTable — Provide the EMM with CSSM function pointers
SYNOPSIS
# include <cssm.h>
CSSM_RETURN CSSMAPI RegisterDispatchTable
(CSSM_STATE_FUNCS_PTR CssmStateCallTable) |
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 ALSO
Books
Intel CDSA Application Developer's Guide
Online Help
Functions: DeregisterDispatchTable
