NAME    [Toc]    [Back]

       CSSM_ModuleLoad  -  Initialize the security service module
       (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN CSSMAPI CSSM_ModuleLoad (const CSSM_GUID *ModuleGuid,
  CSSM_KEY_HIERARCHY  KeyHierarchy,  CSSM_API_ModuleEventHandler
  AppNotifyCallback,  void*  AppNotifyCallbackCtx)

LIBRARY    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       The   GUID  of  the  module  selected  for  loading.   The
       CSSM_KEY_HIERARCHY option directing CSSM what embedded key
       to  use when verifying integrity of the named module.  The
       event notification function provided by the  caller.  This
       defines  the  callback  for  event  notifications from the
       loaded (and later  attached)  service  module.   When  the
       selected  service  module raises an event, this context is
       passed as an input to the event handler specified by  AppNotifyCallback.
   CSSM  does  not  interpret or modify the
       value of AppNotifyCallbackCtx.

DESCRIPTION    [Toc]    [Back]

       This function initializes  the  security  service  module.
       Initialization includes registering the application's module-event
 handler and enabling events  with  the  security
       service service module. The application can choose to provide
 an event handler function to receive notification  of
       insert, remove, and fault events. The specified event handler
 is the single callback point for  all  attached  sessions
 with the specified service module.

       The  function CSSM_Init() must be invoked prior to calling
       CSSM_ModuleLoad(). The function CSSM_ModuleAttach() can be
       invoked multiple times per call to CSSM_ModuleLoad().

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).        CSSMERR_CSSM_INVALID_GUID       CSSMERR_CSSM_ADDIN_LOAD_FAILED
   CSSMERR_CSSM_EMM_LOAD_FAILED
       CSSMERR_CSSM_INVALID_KEY_HIERARCHY

SEE ALSO    [Toc]    [Back]

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



                                               CSSM_ModuleLoad(3)