Index for Section 3

Alphabetical listing for C

Bottom of page

CSP_EventNotify(3)
NAME
  CSP_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
  CSPHandle (input)
	  The handle that describes the add-in cryptographic service provider
	  module used to perform calls to CSSM for the memory functions
	  managed by CSSM.

  Event (input)
	  One of the following event types listed:

	  __________________________________________________________________
	  Event			      Description
	  __________________________________________________________________
	  CSSM_CONTEXT_EVENT_CREATE

				      A caller using this module attach
				      handle has created a new cryptographic
				      context using CSSM_Create***Context.
	  CSSM_CONTEXT_EVENT_DELETE

				      A caller using this module attach
				      handle has deleted a  cryptographic
				      context using CSSM_DeleteContext().
	  CSSM_CONTEXT_EVENT_UPDATE

				      A caller using this module attach
				      handle has updated an existing
				      cryptographic context.
	  __________________________________________________________________

  CCHandle (input)
	  The cryptographic context handle for the context affected by the
	  event.

  Context 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 module
  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 examines
  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
  modifications 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 represent
  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_CreateDigestContext(3),  CSSM_CSP_CreateSymmetricContext(3),
  CSSM_CSP_CreateMacContext(3), CSSM_CSP_CreateRandomGenContext(3),
  CSSM_CSP_CreateAsymmetricContext(3), CSSM_CSP_CreateDeriveKeyContext(3),
  CSSM_CSP_CreateKeyGenContext(3), CSSM_CSP_CreatePassThroughContext(3),
  CSSM_DeleteContext(3), CSSM_UpdateContextAttributes(3)

Index for Section 3

Alphabetical listing for C

Top of page