NAME

EventNotifyManager

SYNOPSIS

CSSM_RETURN CSSMAPI EventNotifyManager
   (CSSM_MANAGER_EVENT_NOTIFICATION_PTR EventDescription)

DESCRIPTION

This function receives an event notification from another module manager. The source manger is identified by its service mask. The specified event type is interpreted by the received and the appropriate actions must be taken in response. EventId and EventData are optional. The EventId is specified by the source module manager when a reply is expected. The destination module manager must used this identifier when replying to the event notification. The EventData is additional data or descriptive information provided to the destination manager.

PARAMETERS

EventDescription-A structure containing the following fields:

DestinationModuleManagerType (input/optional)

The unique service mask identifying the destination module manager.

SourceModuleManagerType (input)

The unique service mask identifying the source module manager.

Event (input)

An identified indicating the event the has or will take place.

EventId (input/optional)

A unique identified associated with this event notification. It must be used in any reply notification that result from this event notification.

EventData (input/optional)

Arbitrary data (required or informational) for this event.

RETURN VALUE

A CSSM_OK return value signifies that the event notification was received, understood, and acted upon. When CSSM_FAIL is returned, the module manager was unable to act appropriately in response to the event notification. Use CSSM_GetError to obtain the error code.

ERRORS

CSSM_MANGER_EVENT_FAIL

Unable to process the event.

SEE ALSO

CSSM_DeliverModuleManagerEvent