NOTIFCALLBACK
Область применения: Outlook 2013 | Outlook 2016
Определяет функцию обратного вызова, которую MAPI вызывает для отправки уведомления о событии. Эту функцию обратного вызова можно использовать только при оболочке в объект приемника рекомендаций, созданный путем вызова функции HrAllocAdviseSink .
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapidefs.h |
| Определена функция, реализованная: |
Клиентские приложения и поставщики услуг |
| Определенная функция, вызываемая: |
MAPI |
ULONG (STDAPICALLTYPE NOTIFCALLBACK)(
LPVOID lpvContext,
ULONG cNotification,
LPNOTIFICATION lpNotifications
);
Параметры
lpvContext
[в] Указатель на произвольное значение, переданное функции обратного вызова при вызове MAPI. Это значение может представлять адрес, важный для клиентского приложения или поставщика услуг. Как правило, для кода C++ параметр lpvContext представляет указатель на объект C++.
cNotification
[в] Количество уведомлений о событиях в массиве, указанном параметром lpNotifications .
lpNotifications
[out] Указатель на расположение, в котором эта функция записывает массив структур NOTIFICATION , содержащих уведомления о событиях.
Возвращаемое значение
Набор допустимых возвращаемых значений для прототипа функции NOTIFCALLBACK зависит от того, реализована ли функция клиентским приложением или поставщиком услуг. Клиенты всегда должны возвращать S_OK. Поставщики могут возвращать S_OK или CALLBACK_DISCONTINUE.
Замечания
CALLBACK_DISCONTINUE является допустимым возвращаемым значением только для синхронных функций обратного вызова; он запрашивает немедленное прекращение обработки обратных вызовов для этого уведомления. Когда возвращается CALLBACK_DISCONTINUE, MAPI задает для параметра lpUlFlags значение NOTIFY_CANCELED при возврате из IMAPISupport::Notify.
Ниже приведены ограничения на то, что может делать синхронная функция обратного вызова.
Это не может привести к созданию другого синхронного уведомления.
Не удается отобразить пользовательский интерфейс.