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

Метод IWiaItem2::EnumChildItems

  • Статья

Создает объект перечислителя и передает указатель обратно в интерфейс IEnumWiaItem2 для папок с элементами в дереве IWiaItem2 устройства windows Image Acquisition (WIA) 2.0.

Синтаксис

HRESULT EnumChildItems(
  [in]  const GUID          *pCategoryGUID,
  [out]       IEnumWiaItem2 **ppIEnumWiaItem2
);

Параметры

pCategoryGUID [in]

Тип: const GUID*

Указывает указатель на категорию, для которой перечисляются дочерние узлы. Если значение РАВНО NULL, перечисляются все дочерние узлы.

ppIEnumWiaItem2 [out]

Тип: IEnumWiaItem2**

Получает адрес указателя на интерфейс IEnumWiaItem2 , создаваемый этим методом.

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

Тип: HRESULT

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

Комментарии

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

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

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

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista [только классические приложения]
Минимальная версия сервера
 Windows Server 2008 [только классические приложения]
Заголовок
Wia.h
IDL
Wia.idl