HP Open Source Security for OpenVMS Volume 1: Common Data Security Architecture > Elective Module Manager (EMM) API Functions

EventNotifyManager

 » Table of Contents

 » Glossary

 » Index

NAME

EventNotifyManager — Receive an event notification

SYNOPSIS

# include <cssm.h>
CSSM_RETURN CSSMAPI EventNotifyManager
(const CSSM_MANAGER_EVENT_NOTIFICATION *EventDescription)

PARAMETERS

EventDescription 

A structure containing the following fields:

DestinationModuleManagerType (input)
  

The unique service mask identifying the destination module manager.

SourceModuleManagerType (input)
  

The unique service mask identifying the source module manager.

Event (input) 

An identifier indicating the event that has or will take place.

EventId (input/optional)
  

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

EventData (input/optional)
  

Arbitrary data (required or informational) for this event.

DESCRIPTION

This function receives an event notification from another module manager. The source manager 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 use this identifier when replying to the event notification. The EventData is additional data or descriptive information provided to the destination manager.

RETURN VALUE

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.

ERRORS

Errors are described in the CDSA Technical Standard.

CSSMERR_CSSM_MODULE_MANAGER_NOT_FOUND

SEE ALSO

Books

Intel CDSA Application Developer's Guide