Método IEnumWiaItem::Next (wia_xp.h)

O método IEnumWiaItem::Next preenche uma matriz de ponteiros para interfaces IWiaItem .

Sintaxe

HRESULT Next(
  [in]      ULONG    celt,
  [out]     IWiaItem **ppIWiaItem,
  [in, out] ULONG    *pceltFetched
);

Parâmetros

[in] celt

Tipo: ULONG

Especifica o número de elementos de matriz na matriz indicada pelo parâmetro ppIWiaItem .

[out] ppIWiaItem

Tipo: IWiaItem**

Recebe o endereço de uma matriz de ponteiros de interface IWiaItem . IEnumWiaItem::Next preenche essa matriz com ponteiros de interface.

[in, out] pceltFetched

Tipo: ULONG*

Na saída, esse parâmetro recebe o número de ponteiros de interface realmente armazenados na matriz indicada pelo parâmetro ppIWiaItem . Quando a enumeração for concluída, esse parâmetro conterá zero.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o método retornará S_OK. Quando a enumeração for concluída, ela retornará S_FALSE. Se o método falhar, ele retornará um código de erro COM padrão.

Comentários

O sistema de tempo de execução WIA (Aquisição de Imagens do Windows) representa dispositivos de hardware WIA como uma árvore hierárquica de objetos IWiaItem . Os aplicativos usam o método IEnumWiaItem::Next para obter um ponteiro de interface IWiaItem para cada item na pasta atual da árvore de objetos IWiaItem de um dispositivo de hardware.

Para obter a lista de ponteiros, o aplicativo passa uma matriz de ponteiros de interface IWiaItem que ele aloca. Ele também passa o número de elementos de matriz no parâmetro celt . O método IEnumWiaItem::Next preenche a matriz com ponteiros para interfaces IWiaItem .

Até que o processo de enumeração seja concluído, o método IEnumWiaItem::Next retornará S_OK. Sempre que isso acontece, ele define o valor apontado por pceltFetched para o número de itens inseridos na matriz. Quando IEnumWiaItem::Next conclui o processo de enumeração de objetos IWiaItem , ele retorna S_FALSE e define o local de memória apontado por pceltFetched como zero.

Os aplicativos devem chamar o método IUnknown::Release nos ponteiros de interface que recebem por meio do parâmetro ppIWiaItem .

Requisitos

Requisito	Valor
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