NAME

   CSP_EventNotify - Notify service module of a context event (CDSA)

 SYNOPSIS

   # include <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 (CDSA$INCSSM300_SHR.EXE)

 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)

   Other Help Topics

   Functions: CSSM_CSP_CreateSignatureContext
              CSSM_CSP_CreateDigestContext
              CSSM_CSP_CreateSymmetricContext
              CSSM_CSP_CreateMacContext
              CSSM_CSP_CreateRandomGenContext
              CSSM_CSP_CreateAsymmetricContext
              CSSM_CSP_CreateDeriveKeyContext
              CSSM_CSP_CreateKeyGenContext
              CSSM_CSP_CreatePassThroughContext
              CSSM_DeleteContext
              CSSM_UpdateContextAttributes