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 |