Поделиться через


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

Создает и управляет вспомогательными соединениями между объектом данных и одним или несколькими вспомогательными приемникам. Его методы предназначены для реализации консультативных методов IDataObject. IDataAdviseHolder реализуется в объекте владельца рекомендаций. Его методы устанавливают и удаляют подключения рекомендаций по данным и отправляют уведомление об изменении данных из объекта данных в объект, для которого требуется это уведомление, например контейнер OLE, который должен содержать приемник рекомендаций.

Приемники рекомендаций — это объекты, требующие уведомления об изменении данных, содержащихся в объекте, и реализующие интерфейс IAdviseSink . Рекомендуется также связать приемники с контейнерами составных документов OLE.

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

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

Методы

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

 
IDataAdviseHolder::Advise

Создает соединение между приемником рекомендаций и объектом данных для получения уведомлений.
IDataAdviseHolder::EnumAdvise

Возвращает объект , который можно использовать для перечисления текущих консультативных подключений.
IDataAdviseHolder::SendOnDataChange

Отправляет уведомления в каждый приемник рекомендаций, для которого установлено соединение, путем вызова метода IAdviseSink::OnDataChange для каждого приемника рекомендаций, который в настоящее время обрабатывается этим экземпляром объекта владельца рекомендаций.
IDataAdviseHolder::Unadvise

Удаляет подключение между объектом данных и приемником рекомендаций, которое было настроено с помощью предыдущего вызова IDataAdviseHolder::Advisory. Этот метод обычно вызывается в реализации IDataObject::D Unadvise.

Требования

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

См. также раздел

IAdviseSink

Idataobject