NOTIFCALLBACK
Gilt für: Outlook 2013 | Outlook 2016
Definiert eine Rückruffunktion, die MAPI aufruft, um eine Ereignisbenachrichtigung zu senden. Diese Rückruffunktion kann nur verwendet werden, wenn sie in ein Durch aufrufen der Funktion HrAllocAdviseSink erstelltes Beratungssenkenobjekt eingeschlossen wird.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
| Definierte Funktion implementiert von: |
Clientanwendungen und Dienstanbieter |
| Definierte Funktion aufgerufen von: |
MAPI |
ULONG (STDAPICALLTYPE NOTIFCALLBACK)(
LPVOID lpvContext,
ULONG cNotification,
LPNOTIFICATION lpNotifications
);
Parameter
lpvContext
[in] Zeiger auf einen beliebigen Wert, der an die Rückruffunktion übergeben wird, wenn MAPI ihn aufruft. Dieser Wert kann eine Adresse darstellen, die für die Clientanwendung oder den Dienstanbieter von Bedeutung ist. In der Regel stellt der Parameter lpvContext für C++-Code einen Zeiger auf ein C++-Objekt dar.
cNotification
[in] Anzahl der Ereignisbenachrichtigungen in dem Array, das durch den lpNotifications-Parameter angegeben wird.
lpNotifications
[out] Zeiger auf den Speicherort, an dem diese Funktion ein Array von NOTIFICATION-Strukturen schreibt, das die Ereignisbenachrichtigungen enthält.
Rückgabewert
Der Satz gültiger Rückgabewerte für den Funktionsprototyp NOTIFCALLBACK hängt davon ab, ob die Funktion von einer Clientanwendung oder einem Dienstanbieter implementiert wird. Clients sollten immer S_OK zurückgeben. Anbieter können entweder S_OK oder CALLBACK_DISCONTINUE zurückgeben.
Hinweise
CALLBACK_DISCONTINUE ist nur für synchrone Rückruffunktionen ein gültiger Rückgabewert. Sie fordert die MAPI auf, die Verarbeitung der Rückrufe für diese Benachrichtigung sofort zu beenden. Wenn CALLBACK_DISCONTINUE zurückgegeben wird, legt MAPI den lpUlFlags-Parameter auf NOTIFY_CANCELED fest, wenn er von IMAPISupport::Notify zurückgegeben wird.
Im Folgenden finden Sie Einschränkungen hinsichtlich der Möglichkeiten einer synchronen Rückruffunktion:
Es kann nicht dazu führen, dass eine weitere synchrone Benachrichtigung generiert wird.
Eine Benutzeroberfläche kann nicht angezeigt werden.