HELPLIB.HLB  —  CDSA  CDSA_API, RegisterDispatchTable
 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
Close Help