IMAPIForm::Advise
Область применения: Outlook 2013 | Outlook 2016
Регистрирует средство просмотра форм для уведомлений о событиях, влияющих на форму.
HRESULT Advise(
LPMAPIVIEWADVISESINK pAdvise,
ULONG FAR * pulConnection
);
Параметры
pAdvise
[в] Указатель на объект приемника представления рекомендует получать последующие уведомления.
pulConnection
[out] Указатель на ненулевое значение, представляющее успешную регистрацию уведомления.
Возвращаемое значение
S_OK
Регистрация прошла успешно.
E_OUTOFMEMORY
Регистрация не удалась из-за нехватки памяти.
Замечания
Средства просмотра форм вызывают метод IMAPIForm::Advise формы, чтобы зарегистрироваться для уведомления о внесении изменений в форму.
Примечания для исполнителей
Сохраните копию указателя приемника рекомендаций представления, переданного в параметре pAdvise , чтобы использовать его для вызова соответствующего метода IMAPIViewAdviseSink при возникновении события. Вызовите метод IUnknown::AddRef приемника, чтобы сохранить указатель до отмены регистрации уведомления. Задайте для содержимого параметра pulConnection ненулевое число.
Многие формы реализуют вспомогательный объект для обработки регистрации и последующего уведомления о событиях.
Дополнительные сведения о процессе уведомления в целом см. в разделе Уведомление о событиях в MAPI.
Дополнительные сведения об уведомлениях и формах см. в разделе Отправка и получение уведомлений формы.