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 |
|
IDL |
|