NAME
CSSM_SPI_ModuleLoad — Initialize process between CSSM and the add-in service
module (CDSA)
SYNOPSIS
# include <cssm.h>
CSSM_RETURN CSSMSPI CSSM_SPI_ModuleLoad
(const CSSM_GUID *CssmGuid,
const CSSM_GUID *ModuleGuid,
CSSM_SPI_ModuleEventHandler CssmNotifyCallback,
void* CssmNotifyCallbackCtx) |
LIBRARY
Common Security Services Manager library (cdsa$incssm300_shr.exe)
PARAMETERS
| CssmGuid (input) | | The CSSM_GUID of the caller. Used to locate the
caller's signed manifest credentials. |
| ModuleGuid (input) |
| | | The CSSM_GUID of the invoked service provider module.
Used to locate the module's signed manifest credentials. |
| CssmNotifyCallback (input) |
| | | A function pointer for the CSSM event handler that
manages events of type CSSM_MODULE_EVENT. |
| CssmNotifyCallbackCtx (input) |
| | | The context to be returned to CSSM as input on each
callback to the event handler defined by CssmNotifyCallback. |
DESCRIPTION
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
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
Errors are described in the CDSA Technical Standard.
SEE ALSO
Books
Intel CDSA Application Developer's Guide
Online Help
Functions: CSSM_SPI_ModuleAttach, CSSM_SPI_ModuleUnload
