NAME    [Toc]    [Back]

       CSSM_ModuleUnload  -  Deregister  event notification callbacks
 (CDSA)

SYNOPSIS    [Toc]    [Back]

       # include <cdsa/cssm.h>

       CSSM_RETURN  CSSMAPI  CSSM_ModuleUnload  (const  CSSM_GUID
       *ModuleGuid,   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 unloading.  The  event
       notification  function  to  be  deregistered. The function
       must  have  been  provided  by  the  caller  in  CSSM_ModuleLoad().
   The  event notification context that was provided
 in the corresponding call to CSSM_ModuleLoad().

DESCRIPTION    [Toc]    [Back]

       The function deregisters event notification callbacks  for
       the  caller  identified  by ModuleGuid. The CSSM_ModuleUnload()
 function is the analog call  to  CSSM_ModuleLoad().
       If  all  callbacks  registered with CSSM are removed, then
       CSSM unloads the service module that was loaded  by  calls
       to  CSSM_ModuleLoad().   Calls to CSSM_ModuleUnload() that
       are not matched with a previous call to  CSSM_ModuleLoad()
       result in an error.

       The  CSSM uses the three input parameters ModuleGuid, AppNotifyCallback,
 and AppNotifyCallbackCtx to uniquely identify
 registered callbacks.

       This  function should be invoked after all necessary calls
       to CSSM_ModuleDetach() have been performed.

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_ADDIN_UNLOAD_FAILED   CSSMERR_CSSM_EMM_UNLOAD_FAILED
   CSSMERR_CSSM_EVENT_NOTIFICATION_CALLBACK_NOT_FOUND

SEE ALSO    [Toc]    [Back]

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



                                             CSSM_ModuleUnload(3)