Метод IOleObject::EnumAdvise (oleidl.h)
Извлекает указатель на перечислитель, который можно использовать для перечисления консультативных подключений, зарегистрированных для объекта , чтобы контейнер знал, что следует освободить перед закрытием.
Синтаксис
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
Параметры
[out] ppenumAdvise
Адрес переменной указателя IEnumSTATDATA , которая получает указатель интерфейса на объект перечислителя. Если у объекта нет консультативных подключений или возникает ошибка, реализация должна задать для ppenumAdviseзначение NULL. Каждый раз, когда объект получает успешный вызов IOleObject::EnumAdvise, он должен увеличивать количество ссылок в ppenumAdvise. Вызывающий объект отвечает за вызов Release после завершения работы с ppenumAdvise.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
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 |