Método IWiaItem2::EnumChildItems

Crea un objeto enumerador y pasa un puntero a su interfaz IEnumWiaItem2 para carpetas con elementos en el árbol IWiaItem2 de un dispositivo Windows Image Acquisition (WIA) 2.0.

Sintaxis

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

Parámetros

pCategoryGUID [in]

Tipo: GUID const*

Especifica un puntero a una categoría para la que se enumeran los nodos secundarios. Si es NULL, se enumeran todos los nodos secundarios.

ppIEnumWiaItem2 [out]

Tipo: IEnumWiaItem2**

Recibe la dirección de un puntero a la interfaz IEnumWiaItem2 que crea este método.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El sistema en tiempo de ejecución de WIA 2.0 representa cada dispositivo de hardware WIA 2.0 como un árbol jerárquico de objetos IWiaItem2 . El método IWiaItem2::EnumChildItems permite a las aplicaciones enumerar elementos secundarios en el elemento actual. Sin embargo, solo se puede aplicar a los elementos que son carpetas.

Si la carpeta no está vacía, contiene un subárbol de objetos IWiaItem2 . El método IWiaItem2::EnumChildItems enumera todos los elementos contenidos en la carpeta. Almacena un puntero a un enumerador en el parámetro ppIEnumWiaItem2 . Las aplicaciones usan el puntero del enumerador para realizar la enumeración de los elementos secundarios de un objeto.

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIEnumWiaItem2 .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h
IDL	Wia.idl