HrAllocAdviseSink

Область применения: Outlook 2013 | Outlook 2016

Создает объект приемника рекомендаций с учетом контекста, заданного реализацией вызова, и функцией обратного вызова, активируемой уведомлением о событии.

Свойство	Значение
Файл заголовка:	Mapiutil.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики услуг

STDAPI HrAllocAdviseSink(
  LPNOTIFCALLBACK lpfnCallback,
  LPVOID lpvContext,
  LPMAPIADVISESINK FAR * lppAdviseSink
);

Параметры

lpfnCallback

[в] Указатель на функцию обратного вызова на основе прототипа NOTIFCALLBACK , который MAPI будет вызывать при возникновении события уведомления для только что созданного приемника рекомендаций.

lpvContext

[в] Указатель на данные вызывающего абонента, передаваемые функции обратного вызова при вызове MAPI. Данные вызывающего объекта могут представлять важный адрес для клиента или поставщика. Как правило, для кода C++ параметр lpvContext представляет указатель на адрес объекта .

lppAdviseSink

[out] Указатель на указатель на объект приемника рекомендаций.

Возвращаемое значение

Нет.

Замечания

Чтобы использовать функцию HrAllocAdviseSink , клиентское приложение или поставщик услуг создает объект для получения уведомлений, создает функцию обратного вызова уведомлений на основе прототипа функции NOTIFCALLBACK , которая входит в этот объект, и передает указатель на объект в функции HrAllocAdviseSink в качестве значения lpvContext . При этом выполняется уведомление; и в рамках процесса уведомления MAPI вызывает функцию обратного вызова с указателем объекта в качестве контекста.

MAPI реализует подсистему уведомлений асинхронно. В C++ обратный вызов уведомления может быть объектным методом. Если объект, создающий уведомление, отсутствует, клиент или поставщик, запрашивающий уведомление, должен оставить отдельное количество ссылок для этого объекта для приемника рекомендаций объекта.

Предостережение

HrAllocAdviseSink следует использовать экономно; клиентам безопаснее создавать собственные приемники рекомендаций.