Método IWiaItem2::EnumChildItems
Cria um objeto enumerador e retorna um ponteiro para sua interface IEnumWiaItem2 para pastas com itens na árvore IWiaItem2 de um dispositivo WIA (Aquisição de Imagem do Windows) 2.0.
Sintaxe
HRESULT EnumChildItems(
[in] const GUID *pCategoryGUID,
[out] IEnumWiaItem2 **ppIEnumWiaItem2
);
Parâmetros
-
pCategoryGUID [in]
-
Tipo: const GUID*
Especifica um ponteiro para uma categoria para a qual os nós filho são enumerados. Se FOR NULL, todos os nós filho serão enumerados.
-
ppIEnumWiaItem2 [out]
-
Tipo: IEnumWiaItem2**
Recebe o endereço de um ponteiro para a interface IEnumWiaItem2 que esse método cria.
Valor retornado
Tipo: HRESULT
Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .
Comentários
O sistema de tempo de execução WIA 2.0 representa cada dispositivo de hardware WIA 2.0 como uma árvore hierárquica de objetos IWiaItem2 . O método IWiaItem2::EnumChildItems permite que os aplicativos enumerem itens filho no item atual. No entanto, ele só pode ser aplicado a itens que são pastas.
Se a pasta não estiver vazia, ela conterá uma subárvore de objetos IWiaItem2 . O método IWiaItem2::EnumChildItems enumera todos os itens contidos na pasta. Ele armazena um ponteiro para um enumerador no parâmetro ppIEnumWiaItem2 . Os aplicativos usam o ponteiro enumerador para executar a enumeração dos itens filho de um objeto.
Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppIEnumWiaItem2 .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2008 [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|