Метод 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 [только классические приложения] |
| Заголовок |
|
| IDL |
|