IMAPITable::Unadvise
Область применения: Outlook 2013 | Outlook 2016
Отменяет отправку уведомлений, ранее настроенных с помощью вызова метода IMAPITable::Advise .
HRESULT Unadvise(
ULONG_PTR ulConnection
);
Параметры
ulConnection
[в] Номер подключения регистрации, возвращенный вызовом IMAPITable::Advise.
Возвращаемое значение
S_OK
The call succeeded.
Замечания
Используйте метод IMAPITable::Unadvise , чтобы освободить указатель на объект приемника рекомендаций, переданный в параметре lpAdviseSink в предыдущем вызовеIMAPITable::Advise, тем самым отменив регистрацию уведомления. В рамках отмены указателя на объект приемника рекомендаций вызывается метод IUnknown::Release объекта. Как правило, метод Release вызывается во время вызова Unadvise , но если другой поток находится в процессе вызова метода IMAPIAdviseSink::OnNotify для приемника рекомендаций , вызов Release откладывается до тех пор, пока не будет возвращен метод OnNotify .
Дополнительные сведения о процессе уведомления см. в разделе Уведомление о событиях в MAPI. Дополнительные сведения об уведомлениях таблицы см. в разделе Сведения об уведомлениях о таблицах. Сведения об использовании методов IMAPISupport для поддержки уведомлений см. в разделе Поддержка уведомлений о событиях.
Справочные материалы по MFCMAPI
Пример кода MFCMAPI указан в приведенной ниже таблице.
| Файл | Функция | Comment |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::NotificationOff |
MFCMAPI использует метод IMAPITable::Unadvise для отмены уведомлений для таблицы. |