NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       # 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    [Toc]    [Back]

       Common Security Services Manager library (libcssm.so)

PARAMETERS    [Toc]    [Back]

       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 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.
              -------------------------------------------------------------------
              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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Books

       Intel    CDSA    Application    Developer's   Guide   (see
       CDSA_intro(3))

       Reference Pages    [Toc]    [Back]

       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)



                                               CSP_EventNotify(3)