Метод IWiaItem::EnumChildItems (wia_xp.h)

Метод IWiaItem::EnumChildItems создает объект перечислителя и передает указатель обратно на интерфейс IEnumWiaItem для непустых папок в дереве IWiaItem устройства windows Image Acquisition (WIA).

Синтаксис

HRESULT EnumChildItems(
  [out] IEnumWiaItem **ppIEnumWiaItem
);

Параметры

[out] ppIEnumWiaItem

Тип: IEnumWiaItem**

Получает адрес указателя на интерфейс IEnumWiaItem , создаваемый IWiaItem::EnumChildItems .

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Система времени выполнения WIA представляет каждое аппаратное устройство WIA в виде иерархического дерева объектов IWiaItem . Метод IWiaItem::EnumChildItems позволяет приложениям перечислять дочерние элементы в текущем элементе. Однако его можно применять только к элементам, которые являются папками.

Если папка не пуста, она содержит поддеревье объектов IWiaItem . Метод IWiaItem::EnumChildItems перечисляет все элементы, содержащиеся в папке . Он сохраняет указатель на перечислитель в параметре ppIEnumWiaItem . Приложения используют указатель перечислителя для выполнения перечисления дочерних элементов объекта.

Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают через параметр ppIEnumWiaItem .

Требования

Минимальная версия клиента	Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wia_xp.h (включая Wia.h)
Библиотека	Wiaguid.lib
DLL	Wiaservc.dll