NAME

EventNotify

SYNOPSIS

CSSM_RETURN CSSMAPI EventNotify
    (CSSM_MODULE_HANDLE Handle, const CSSM_EVENT_TYPE Event, const
    uint32 Param)

DESCRIPTION

This function is used by CSSM to notify the module of certain events such as module attach and detach operations.

PARAMETERS

Handle (input)

The handle that identifies the module to application thread pairing.

Event (input)

The event which is occurring. The possible events are described in the table below.

Event	Description
CSSM_EVENT_ATTACH	The application has requested an attach operation.
CSSM_EVENT_DETACH	The application has requested a detach operation.
CSSM_EVENT_INFOATTACH	An application has requested module info and CSSM wants to obtain the module's dynamic capabilities. The add-in module cannot assume that Initialize or Terminate have been called.
CSSM_EVENT_INFODETACH	CSSM has finished obtaining the module's dynamic capabilities.
CSSM_EVENT_CREATE_CONTEXT	A context has been created.
CSSM_EVENT_DELETE_CONTEXT	A context has been deleted.

Table: Module Event Types

---

Param (input)

An event-specific parameter.

Event	Parameter
CSSM_EVENT_ATTACH	None.
CSSM_EVENT_DETACH	None.
CSSM_EVENT_INFOATTACH	None
CSSM_EVENT_INFODETACH	None
CSSM_EVENT_CREATE_CONTEXT	The context handle.
CSSM_EVENT_DELETE_CONTEXT	The context handle.

Table: Module Event Parameters

RETURN VALUE

A CSSM_OK return value signifies that the module's event-specific operations were successfully performed. When CSSM_FAIL is returned, an error has occurred. Use CSSM_GetError to obtain the error code.

SEE ALSO

Initialize, Terminate

---

Why not acquire a nicely bound hard copy?
Click here to return to the publication details or order a copy of this publication.
You should also read the legal notice explaining the terms and conditions relating to the CDSA documentation.

Contents

Next section

Index