NOTIFICATION
Gilt für: Outlook 2013 | Outlook 2016
Enthält Informationen zu einem aufgetretenen Ereignis und zu den Daten, die vom Ereignis betroffen sind.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
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
Typ des aufgetretenen Benachrichtigungsereignisses. Der Wert des ulEventType-Elements entspricht der Struktur, die in der Info-Union enthalten ist. Das ulEventType-Element kann auf einen der folgenden Werte festgelegt werden:
fnevCriticalError
Es ist ein globaler Fehler aufgetreten, z. B. wird die Sitzung gerade heruntergefahren. Das Infoelement enthält eine ERROR_NOTIFICATION-Struktur .
fnevExtended
Ein von einem bestimmten Dienstanbieter definiertes internes Ereignis ist aufgetreten. Das Infoelement enthält eine EXTENDED_NOTIFICATION-Struktur .
fnevNewMail
Eine Nachricht wurde an den entsprechenden Empfangsordner für die Nachrichtenklasse übermittelt und wartet darauf, verarbeitet zu werden. Das Infoelement enthält eine NEWMAIL_NOTIFICATION-Struktur .
fnevObjectCopied
Ein MAPI-Objekt wurde kopiert. Das Infoelement enthält eine OBJECT_NOTIFICATION-Struktur .
fnevObjectCreated
Ein MAPI-Objekt wurde erstellt. Das Infoelement enthält eine OBJECT_NOTIFICATION-Struktur .
fnevObjectDeleted
Ein MAPI-Objekt wurde gelöscht. Das Infoelement enthält eine OBJECT_NOTIFICATION-Struktur .
fnevObjectModified
Ein MAPI-Objekt wurde geändert. Das Infoelement enthält eine OBJECT_NOTIFICATION-Struktur .
fnevObjectMoved
Ein Nachrichtenspeicher- oder Adressbuchobjekt wurde verschoben. Das Infoelement enthält eine OBJECT_NOTIFICATION-Struktur .
fnevSearchComplete
Ein Suchvorgang wurde abgeschlossen, und die Ergebnisse sind verfügbar. Das Infoelement enthält eine OBJECT_NOTIFICATION-Struktur .
fnevTableModified
Die Informationen in einer Tabelle wurden geändert. Das Infoelement enthält eine TABLE_NOTIFICATION-Struktur .
info
Vereinigung von Benachrichtigungsstrukturen, die die betroffenen Daten für einen bestimmten Ereignistyp beschreiben. Die im Info-Member enthaltene Struktur hängt vom Wert des ulEventType-Elements ab.
Hinweise
Mindestens eine NOTIFICATION-Struktur wird bei jedem Aufruf der IMAPIAdviseSink::OnNotify-Methode einer registrierten Empfehlungssenke als Eingabeparameter übergeben. Die NOTIFICATION-Strukturen enthalten Informationen zu den bestimmten Ereignissen, die aufgetreten sind, und beschreiben die betroffenen Objekte.
Bevor Clients oder Dienstanbieter, die eine Benachrichtigung erhalten, die -Struktur zum Verarbeiten des Ereignisses verwenden können, müssen sie den Ereignistyp wie im ulEventType-Member angegeben überprüfen. Im hier gezeigten Codebeispiel wird beispielsweise überprüft, ob eine neue Nachricht empfangen wird, und beim Erkennen eines solchen Ereignisses wird die Nachrichtenklasse der Nachricht ausgegeben.
if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}
Weitere Informationen zu Benachrichtigungen finden Sie in den in der folgenden Tabelle beschriebenen Themen.
| Thema | Beschreibung |
|---|---|
| Ereignisbenachrichtigung in MAPI |
Allgemeine Übersicht über Benachrichtigungs- und Benachrichtigungsereignisse. |
| Behandeln von Benachrichtigungen |
Erläuterung, wie Clients Benachrichtigungen behandeln sollten. |
| Unterstützende Ereignisbenachrichtigung |
Erläuterung, wie Dienstanbieter die IMAPISupport-Methode verwenden können, um Benachrichtigungen zu generieren. |