NOTIFICATION
The NOTIFICATION structure contains information about an event that has occurred and the data that has been affected by the event.
Syntax
typedef 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 Remarks 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.
The ulEventType member can be one of the following flags:
| Flag | Value | Description |
|---|---|---|
| fnevCriticalError | 0x00000001 | A global error has occurred, such as a session shut down in progress. The info member contains an ERROR_NOTIFICATION structure. |
| fnevExtended | 0x80000000 | An internal event defined by a particular service provider has occurred. The info member contains an EXTENDED_NOTIFICATION structure. |
| fnevNewMail | 0x00000002 | A message has been delivered to the appropriate receive folder for the message class and is waiting to be processed. The info member contains a NEWMAIL_NOTIFICATION structure. |
| fnevObjectCopied | 0x00000040 | A MAPI object has been copied. The info member contains an OBJECT_NOTIFICATION structure. |
| fnevObjectCreated | 0x00000004 | A MAPI object has been created. The info member contains an OBJECT_NOTIFICATION structure. |
| fnevObjectDeleted | 0x00000008 | A MAPI object has been deleted. The info member contains an OBJECT_NOTIFICATION structure. |
| fnevObjectModified | 0x00000010 | A MAPI object has changed. The info member contains an OBJECT_NOTIFICATION structure. |
| fnevObjectMoved | 0x00000020 | A message store or address book object has been moved. The info member contains an OBJECT_NOTIFICATION structure. |
| fnevSearchComplete | 0x00000080 | A search operation has finished, and the results are available. The info member contains an OBJECT_NOTIFICATION structure. |
| fnevTableModified | 0x00000100 | Information in a table has changed. The info member contains a TABLE_NOTIFICATION structure. |
Requirements
Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: mapidefs.h
See Also
Last updated on Friday, April 22, 2005
© 2005 Microsoft Corporation. All rights reserved.
Send feedback on this topic to the authors.