CSSM_ModuleLoad(3)CSSM_ModuleLoad(3)NAMECSSM_ModuleLoad - Initialize the security service module (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
CSSM_RETURN CSSMAPI CSSM_ModuleLoad (const CSSM_GUID *ModuleGuid,
CSSM_KEY_HIERARCHY KeyHierarchy, CSSM_API_ModuleEventHandler AppNotify‐
Callback, void* AppNotifyCallbackCtx)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
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
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 applica‐
tion can choose to provide an event handler function to receive notifi‐
cation of insert, remove, and fault events. The specified event handler
is the single callback point for all attached sessions with the speci‐
fied service module.
The function CSSM_Init() must be invoked prior to calling CSSM_Mod‐
uleLoad(). The function CSSM_ModuleAttach() can be invoked multiple
times per call to CSSM_ModuleLoad().
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values repre‐
sent an error condition.
ERRORS
Errors are described in the CDSA technical standard. See
CDSA_intro(3). CSSMERR_CSSM_INVALID_GUID CSS‐
MERR_CSSM_ADDIN_LOAD_FAILED CSSMERR_CSSM_EMM_LOAD_FAILED CSS‐
MERR_CSSM_INVALID_KEY_HIERARCHY
SEE ALSO
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
CSSM_ModuleLoad(3)