CSSM_SPI_ModuleLoad

If both a Table of Contents and Search form are not displayed in separate frames along with this one, you may wish to redisplay this book in a frameset, beginning with the first page.

HP Open Source Security for OpenVMS Volume 1:...

API Functions

CSSM_SPI_ModuleDetach

CSSM_SPI_ModuleUnload

CSSM_SPI_ModuleLoad

Library
Description
Errors

Parameters
Return Value
See Also

NAME

CSSM_SPI_ModuleLoad - Initialize process between CSSM and the add-in servicemodule (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 thecaller'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 thatmanages events of type CSSM_MODULE_EVENT.
`CssmNotifyCallbackCtx` (input)
		The context to be returned to CSSM as input on eachcallback to the event handler defined by `CssmNotifyCallback`.

DESCRIPTION

This function completes the module initialization processbetween CSSM and the add-in service module. Before invoking thisfunction, 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 callerand should be used by the module to locate the caller's signed manifestcredentials and to complete integrity verification and secure linkagechecks on the caller. The ModuleGuid identifiesthe invoked module and should be used by the module to locate itscredentials and to complete an integrity self-check.

The CssmNotifyCallback and CssmNotifyCallbackCtx parametersdefine a callback and callback context respectively. The modulemust retain this information for later use. The module should usethe callback to notify CSSM of module events of type CSSM_MODULE_EVENTin any ongoing, attached sessions.

RETURN VALUE

A CSSM_RETURN value indicating success or specifying a particularerror condition. The value CSSM_OK indicates success. All othervalues represent an error condition.

ERRORS

Errors are described in the CDSA Technical Standard.