Previous section.

Common Security: CDSA and CSSM
Copyright © 1997 The Open Group

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