CSP_EventNotify(3)CSP_EventNotify(3)NAMECSP_EventNotify - Notify service module of a context event (CDSA)
SYNOPSIS
# include <cdsa/cssm.h>
CSSM_RETURN CSSMSPI CSP_EventNotify (CSSM_MODULE_HANDLE CSPHandle,
CSSM_CONTEXT_EVENT Event, CSSM_CC_HANDLE CCHandle, const CSSM_CONTEXT
*Context)
LIBRARY
Common Security Services Manager library (libcssm.so)
PARAMETERS
The handle that describes the add-in cryptographic service provider
module used to perform calls to CSSM for the memory functions managed
by CSSM. One of the following event types listed:
───────────────────────────────────────────────────────────────────
Event Description
───────────────────────────────────────────────────────────────────
CSSM_CONTEXT_EVENT_CREATE A caller using this module attach han‐
dle has created a new cryptographic
context using CSSM_Create***Context.
CSSM_CONTEXT_EVENT_DELETE A caller using this module attach han‐
dle has deleted a cryptographic con‐
text using CSSM_DeleteContext().
CSSM_CONTEXT_EVENT_UPDATE A caller using this module attach han‐
dle has updated an existing crypto‐
graphic context.
───────────────────────────────────────────────────────────────────
The cryptographic context handle for the context affected by the
event. A pointer to the cryptographic context affected by the
event. The results of the event are visible in the context.
DESCRIPTION
This function is used to notify the service module of a context event
related to a particular attach handle. Valid events include creation,
deletion, or modification of a cryptographic context. The service mod‐
ule can examine the new or modified context referenced by pContext to
determine whether the context is acceptable to the service module.
If the cryptographic context is acceptable (if the service module exam‐
ines the contents of the context only upon use of the context), then
the service module should return CSSM_OK. If the cryptographic context
is not acceptable, then the service module should return CSSM_FAIL.
Upon receiving a return value of CSSM_OK, CSSM completes the operation
signaled by this event and returns to the calling application. If the
return value is CSSM_FAIL, CSSM deletes a newly created context or mod‐
ifications to an existing context, and returns the failed result to the
calling application. When deleting a cryptographic context, CSSM always
returns success to the calling application.
RETURN VALUE
A CSSM_RETURN value indicating success or specifying a particular error
condition. The value CSSM_OK indicates success. All other values rep‐
resent an error condition.
SEE ALSO
Books
Intel CDSA Application Developer's Guide (see CDSA_intro(3))
Reference Pages
Functions: CSSM_CSP_CreateSignatureContext(3), CSSM_CSP_CreateDigest‐
Context(3),
CSSM_CSP_CreateSymmetricContext(3), CSSM_CSP_CreateMacContext(3),
CSSM_CSP_CreateRandomGenContext(3), CSSM_CSP_CreateAsymmetricCon‐
text(3), CSSM_CSP_CreateDeriveKeyContext(3), CSSM_CSP_CreateKeyGenCon‐
text(3), CSSM_CSP_CreatePassThroughContext(3), CSSM_DeleteContext(3),
CSSM_UpdateContextAttributes(3)CSP_EventNotify(3)