Интерфейс IAdviseSink (objidl.h)

Статья
03/05/2024

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

Для создания консультативного подключения объект, который получает уведомления, должен реализовывать IAdviseSink, а объекты, в которых он заинтересован, должны реализовывать IOleObject::Advise и IDataObject::D Advise. Внутрипроцессные объекты и обработчики также могут реализовывать IViewObject::SetAdvise. Объекты, реализующие IOleObject , должны поддерживать все разумные методы рекомендаций. Чтобы упростить уведомления о рекомендациях, OLE предоставляет реализации IDataAdviseHolder и IOleAdviseHolder, которые отслеживают подключения рекомендаций и отправляют уведомления в соответствующие приемники через указатели на интерфейсы IAdviseSink . IViewObject (и его методы рекомендаций) реализован в обработчике по умолчанию.

Как показано в следующей таблице, объект, реализующий приемник рекомендаций, регистрирует свою заинтересованность в получении определенных типов уведомлений путем вызова соответствующего метода.

Вызов этого метода	Регистрация для получения этих уведомлений
IOleObject::Advise	При сохранении, закрытии или переименовании документа.
IDataObject::D Advise	При изменении данных документа.
IViewObject::SetAdvise	При изменении представления документа.

При возникновении события, применимого к зарегистрированным типу уведомлений, приложение объекта вызывает соответствующий метод IAdviseSink . Например, когда внедренный объект закрывается, он вызывает метод IAdviseSink::OnClose для уведомления своего контейнера. Эти уведомления являются асинхронными и происходят после событий, которые их активируют.

Наследование

Интерфейс IAdviseSink наследуется от интерфейса IUnknown . IAdviseSink также имеет следующие типы элементов:

Методы

Интерфейс IAdviseSink содержит следующие методы.


IAdviseSink::OnClose Вызывается сервером для уведомления всех зарегистрированных приемников рекомендаций о том, что объект изменился из запущенного в загруженное состояние.
IAdviseSink::OnDataChange Вызывается сервером для уведомления объекта данных, зарегистрированного в настоящее время, сообщает приемникам, что данные в объекте изменились.
IAdviseSink::OnRename Вызывается сервером для уведомления всех зарегистрированных приемников рекомендаций о переименовании объекта.
IAdviseSink::OnSave Вызывается сервером для уведомления всех зарегистрированных приемников рекомендаций о сохранении объекта.
IAdviseSink::OnViewChange Уведомляет зарегистрированные приемники рекомендаций объекта о том, что его представление изменилось.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Профессиональная [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows 2000 Server [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	objidl.h