CSSM_RETURN CSSMAPI EventNotify (CSSM_MODULE_HANDLE Handle, const CSSM_EVENT_TYPE Event, const uint32 Param)
This function is used by CSSM to notify the module of certain events such as module attach and detach operations.
- 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
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.
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