Поделиться через


Метод IOleContainer::EnumObjects (oleidl.h)

Перечисляет объекты в текущем контейнере.

Синтаксис

HRESULT EnumObjects(
  [in]  DWORD        grfFlags,
  [out] IEnumUnknown **ppenum
);

Параметры

[in] grfFlags

Указывает, какие объекты в контейнере необходимо перечислить, как определено в перечислении OLECONTF.

[out] ppenum

Указатель на переменную указателя IEnumUnknown , которая получает указатель интерфейса на объект перечислителя. Каждый раз, когда контейнер получает успешный вызов EnumObjects, он должен увеличивать число ссылок в указателе ppenum , возвращаемом методом. Вызывающий объект несет ответственность за вызов IUnknown::Release после завершения работы с указателем. Если возвращается ошибка, реализация должна присвоить ppenum значение NULL.

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

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

Код возврата Описание
E_FAIL
Операция не удалась.
E_NOTIMPL
Перечисление объектов не поддерживается.

Комментарии

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

Требования

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

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

IEnumUnknown

IOleContainer

IOleItemContainer

OLECONTF