Функция CreateOleAdviseHolder (ole2.h)

Создает объект владельца рекомендаций для управления уведомлениями составных документов. Он возвращает указатель на реализацию OLE объекта интерфейса IOleAdviseHolder .

Синтаксис

HRESULT CreateOleAdviseHolder(
  [out] LPOLEADVISEHOLDER *ppOAHolder
);

Параметры

[out] ppOAHolder

Адрес переменной указателя IOleAdviseHolder , которая получает указатель интерфейса на новый объект-держатель рекомендаций.

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

Эта функция возвращает S_OK об успешном выполнении и поддерживает стандартное возвращаемое значение E_OUTOFMEMORY.

Комментарии

Функция CreateOleAdviseHolder создает экземпляр владельца рекомендаций, который поддерживает реализацию OLE интерфейса IOleAdviseHolder . Методы этого интерфейса предназначены для реализации методов рекомендаций IOleObject, а при настройке консультативных подключений с объектами, поддерживающими приемник рекомендаций, — для отправки уведомлений об изменениях в объекте в приемник рекомендаций. Владелец рекомендаций, возвращенный CreateOleAdviseHolder , будет достаточно для подавляющего большинства приложений. Однако реализация, предоставляемая OLE, не поддерживает IOleAdviseHolder::EnumAdvise, поэтому если вам нужно использовать этот метод, необходимо реализовать собственный владелец рекомендаций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ole2.h
Библиотека	Ole32.lib
DLL	Ole32.dll
Набор API	ext-ms-win-com-ole32-l1-1-3 (представлен в Windows 10 версии 10.0.10240)

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

IOleAdviseHolder

IOleObject