NOTIFICATION

4/8/2010

The NOTIFICATION structure contains information about an event that has occurred and the data that has been effected by the event.

Syntax

struct {
  ULONG   ulEventType;
    union {
          ERROR_NOTIFICATION          err;
          NEWMAIL_NOTIFICATION        newmail;
          OBJECT_NOTIFICATION         obj;
          TABLE_NOTIFICATION          tab;
          EXTENDED_NOTIFICATION       ext;
          STATUS_OBJECT_NOTIFICATION  statobj;
    } info;
} NOTIFICATION, FAR *LPNOTIFICATION;

Members

• ulEventType
  Type of notification event that occurred; this value corresponds to the structure that is included in the info union. See Notification Event Type Flags for information about possible values for this member.

• info
  Union of notification structures describing the affected data for a particular type of event. The structure included info depends on the value of ulEventType.

Remarks

One or more NOTIFICATION structures are passed as input parameters with every call to a registered advise sink's IMAPIAdviseSink::OnNotify method. The NOTIFICATION structures contain information about the particular events that have occurred, and describe the affected objects.

Before clients or service providers receiving a notification can use the structure to process the event, they must check the event type as indicated in the ulEventType member.

Requirements

See Also

Reference

ERROR_NOTIFICATION
EXTENDED_NOTIFICATION
MAPI Structures
NEWMAIL_NOTIFICATION
OBJECT_NOTIFICATION
STATUS_OBJECT_NOTIFICATION
TABLE_NOTIFICATION

Other Resources

Messaging