MAPI Notification Events
Applies to: Outlook 2013 | Outlook 2016
When client applications register for event notification, they must specify one or more events. The events that they can specify depend on the set of events that the intended advise source supports. There are ten types of notifications that clients and service providers can register for, each represented by a constant. Status object notification is an exception. Status object notification is an internal MAPI notification; clients cannot register for it and service providers cannot generate it. The following table describes the types of events and the advise source objects that can support them. The event constant is included with the event type.
| Event type | Description | Advise source objects |
|---|---|---|
| Critical error ( fnevCriticalError) |
A global error or event has occurred, such as a session shutdown in progress. | Session, all types of message store and address book objects, table, status |
| Object modified ( fnevObjectModified) |
A MAPI object has changed. | Folders, messages, all types of address book objects |
| Object created ( fnevObjectCreated) |
A MAPI object has been created. | Folders, messages, all types of address book objects |
| Object moved ( fnevObjectMoved) |
A MAPI object has been moved. | Folders, messages, all types of address book objects |
| Object deleted ( fnevObjectDeleted) |
A MAPI object has been deleted. | Folders, messages, all types of address book objects |
| Object copied ( fnevObjectCopied) |
A MAPI object has been copied. | Folders, messages, all types of address book objects |
| Extended event ( fnevExtended) |
An internal event defined by a particular service provider has occurred. | Any advise source object |
| Search complete ( fnevSearchComplete) |
A search operation has finished and the results of the search are available. | Folders |
| Table modified ( fnevTableModified) |
Information in a MAPI table object has changed. | Tables |
| New mail ( fnevNewMail) |
A message has been delivered and is waiting to be processed. | Message store, folders |
The extended event is defined by a service provider to represent an event that cannot be covered by any of the other predefined events. Only clients that know before they register that a service provider supports an extended event can register for that event. It is not possible for clients to determine without advance knowledge if a service provider supports an extended event and, if it does, how to handle such an event when it is received.