This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here.
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
Contains information about an event that has occurred and the data that has been affected by the event.
Type of notification event that occurred. The value of the ulEventType member corresponds to the structure that is included in the info union.
The ulEventType member can be set to one of the following values:
A global error has occurred, such as a session shut down in progress. The info member contains an ERROR_NOTIFICATION structure.
An internal event defined by a particular service provider has occurred. The info member contains an EXTENDED_NOTIFICATION structure.
A message has been delivered to the appropriate receive folder for the message class and is waiting to be processed. The info member contains an NEWMAIL_NOTIFICATION structure.
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. For example, the code sample that is shown here checks for the arrival of a new message and upon detecting an event of this kind, prints out the message class of the message.