Метод IDataObject::EnumDAdvise (objidl.h)

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

Синтаксис

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

Параметры

[out] ppenumAdvise

Указатель на переменную указателя IEnumSTATDATA , которая получает указатель интерфейса на новый объект перечислителя. Если реализация задает для *ppenumAdviseзначение NULL, то в настоящее время нет подключений для рекомендаций по приемникам.

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

Этот метод возвращает S_OK, если экземпляр объекта перечислителя успешно создан или нет подключений. Ниже перечислены другие возможные значения.

Код возврата	Описание
E_OUTOFMEMORY	Недостаточно памяти для операции.
OLE_E_ADVISENOTSUPPORTED	Этот объект не поддерживает уведомления о рекомендациях.

Комментарии

Объект перечислителя, созданный этим методом, реализует интерфейс IEnumSTATDATA . IEnumSTATDATA разрешает перечисление данных, хранящихся в массиве структур STATDATA . Каждая из этих структур предоставляет сведения об одном консультативном подключении и включает сведения о FORMATETC и ADVF , а также указатель на приемник рекомендаций и маркер, представляющий соединение.

Примечания к вызывающим абонентам

Для обработки подключений рекомендаций рекомендуется использовать объект владельца ole data advisory. С помощью указателя, полученного с помощью вызова CreateDataAdviseHolder, реализация IDataObject::EnumDAdvise становится простым делом делегирования вызова IDataAdviseHolder::EnumAdvise. При этом создается перечислитель и предоставляется указатель на реализацию OLE IEnumSTATDATA. На этом этапе можно вызвать его методы для перечисления текущих консультативных подключений.

Требования

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

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

IDataAdviseHolder::EnumAdvise

Idataobject

IEnumSTATDATA