Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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. |