Método IWiaItem::EnumChildItems (wia_xp.h)

O método IWiaItem::EnumChildItems cria um objeto enumerador e passa um ponteiro para sua interface IEnumWiaItem para pastas não vazias em uma árvore IWiaItem de um dispositivo WIA (Aquisição de Imagens do Windows).

Sintaxe

HRESULT EnumChildItems(
  [out] IEnumWiaItem **ppIEnumWiaItem
);

Parâmetros

[out] ppIEnumWiaItem

Tipo: IEnumWiaItem**

Recebe o endereço de um ponteiro para a interface IEnumWiaItem que IWiaItem::EnumChildItems cria.

Valor retornado

Tipo: HRESULT

Se o 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 representa cada dispositivo de hardware WIA como uma árvore hierárquica de objetos IWiaItem . O método IWiaItem::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 IWiaItem . O método IWiaItem::EnumChildItems enumera todos os itens contidos na pasta. Ele armazena um ponteiro para um enumerador no parâmetro ppIEnumWiaItem . 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 ppIEnumWiaItem .

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wia_xp.h (inclua Wia.h)
Biblioteca	Wiaguid.lib
DLL	Wiaservc.dll