Функция 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) |