Метод IOleObject::EnumAdvise (oleidl.h)

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

Синтаксис

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

Параметры

[out] ppenumAdvise

Адрес переменной указателя IEnumSTATDATA , которая получает указатель интерфейса на объект перечислителя. Если у объекта нет консультативных подключений или возникает ошибка, реализация должна задать для ppenumAdviseзначение NULL. Каждый раз, когда объект получает успешный вызов IOleObject::EnumAdvise, он должен увеличивать количество ссылок в ppenumAdvise. Вызывающий объект отвечает за вызов Release после завершения работы с ppenumAdvise.

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

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата	Описание
E_NOTIMPL	IOleObject::EnumAdvise не реализован.

Комментарии

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

Перечислитель, к которому вы получаете доступ через IOleObject::EnumAdvise , перечисляет элементы типа STATDATA. Получив указатель, контейнер может выполнить цикл по STATDATA и вызвать IOleObject::Unadvise для каждого перечисленного подключения.

Обычно эта функция реализуется путем делегирования вызова интерфейса IOleAdviseHolder . Для IOleObject::EnumAdvise относятся только члены pAdvise и dwConnectionSTATDATA.

Требования

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

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

IOleObject

IOleObject::Advise

IOleObject::Unadvise