NOTIFICATION

Send Feedback

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

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h

See Also

ERROR_NOTIFICATION | EXTENDED_NOTIFICATION | MAPI Structures | Messaging | NEWMAIL_NOTIFICATION | OBJECT_NOTIFICATION | STATUS_OBJECT_NOTIFICATION | TABLE_NOTIFICATION

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.