Método IEnumWiaItem2::Next
Preenche uma matriz de ponteiros para interfaces IWiaItem2 .
Sintaxe
HRESULT Next(
[in] ULONG cElt,
[out] IWiaItem2 **ppIWiaItem2,
[in, out] ULONG *pcEltFetched
);
Parâmetros
-
cElt [in]
-
Tipo: ULONG
Especifica o número de elementos de matriz na matriz indicada pelo parâmetro ppIWiaItem2 .
-
ppIWiaItem2 [out]
-
Tipo: IWiaItem2**
Recebe o endereço de uma matriz de ponteiros de interface IWiaItem2 . IEnumWiaItem2::Next preenche essa matriz com ponteiros de interface.
-
pcEltFetched [in, out]
-
Tipo: ULONG*
Na saída, esse parâmetro recebe o número de ponteiros de interface realmente armazenados na matriz indicada pelo parâmetro ppIWiaItem2 . Quando a enumeração for concluída, esse parâmetro conterá zero.
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 (Aquisição de Imagens do Windows) 2.0 representa dispositivos de hardware WIA 2.0 como uma árvore hierárquica de objetos IWiaItem2 . Os aplicativos usam o método IEnumWiaItem2::Next para obter um ponteiro de interface IWiaItem2 para cada item na pasta atual da árvore de objetos IWiaItem2 de um dispositivo de hardware.
Para obter a lista de ponteiros, o aplicativo passa uma matriz de ponteiros de interface IWiaItem2 que ele aloca. Ele também passa o número de elementos de matriz no parâmetro cElt. O método IEnumWiaItem2::Next preenche a matriz com ponteiros para interfaces IWiaItem2 .
Até que o processo de enumeração seja concluído, o método IEnumWiaItem2::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 IEnumWiaItem2::Next conclui o processo de enumeração de objetos IWiaItem2 , 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 ppIWiaItem2 .
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 |
|