NAME    [Toc]    [Back]

       RegisterDispatchTable - Provide the EMM with CSSM function
       pointers (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN         CSSMAPI          RegisterDispatchTable
       (CSSM_STATE_FUNCS_PTR CssmStateCallTable)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Errors  are described in the CDSA technical standard.  See
       CDSA_intro(3).

SEE ALSO    [Toc]    [Back]

       Books

       Intel   CDSA   Application    Developer's    Guide    (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       Functions: DeregisterDispatchTable(3)



                                         RegisterDispatchTable(3)