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