NAME    [Toc]    [Back]

       CSSM_SPI_ModuleLoad  - Initialize process between CSSM and
       the add-in service module (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN CSSMSPI CSSM_SPI_ModuleLoad  (const  CSSM_GUID
       *CssmGuid,   const  CSSM_GUID  *ModuleGuid,  CSSM_SPI_ModuleEventHandler
 CssmNotifyCallback, void*  CssmNotifyCallbackCtx)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The  CSSM_GUID  of the caller. Used to locate the caller's
       signed manifest credentials.  The CSSM_GUID of the invoked
       service  provider  module.  Used  to  locate  the module's
       signed manifest credentials.  A function pointer  for  the
       CSSM  event  handler that manages events of type CSSM_MODULE_EVENT.
  The context to be returned to CSSM as input on
       each  callback to the event handler defined by CssmNotifyCallback.

DESCRIPTION    [Toc]    [Back]

       This function completes the module initialization  process
       between  CSSM and the add-in service module. Before invoking
 this function, CSSM verifies the add-in  service  module's
 manifest credentials. If the credentials verify this
       module   is   loaded   (physically   if   required),   the
       CSSM_SPI_ModuleLoad() function is invoked.

       The CssmGuid parameter identifies the caller and should be
       used by the module to locate the caller's signed  manifest
       credentials  and  to  complete  integrity verification and
       secure linkage checks on the caller.  The ModuleGuid identifies
 the invoked module and should be used by the module
       to locate its credentials and  to  complete  an  integrity
       self-check.

       The  CssmNotifyCallback  and CssmNotifyCallbackCtx parameters
 define a callback and callback context  respectively.
       The module must retain this information for later use. The
       module should use the callback to notify  CSSM  of  module
       events  of type CSSM_MODULE_EVENT in any ongoing, attached
       sessions.

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:  CSSM_SPI_ModuleAttach(3),   CSSM_SPI_ModuleUnload(3)



                                           CSSM_SPI_ModuleLoad(3)