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