Compartilhar via

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

  • Artigo

O método IEnumWIA_DEV_INFO::Next preenche uma matriz de ponteiros para interfaces IWiaPropertyStorage .

Sintaxe

HRESULT Next(
  [in]      ULONG               celt,
  [out]     IWiaPropertyStorage **rgelt,
  [in, out] ULONG               *pceltFetched
);

Parâmetros

[in] celt

Tipo: ULONG

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

[out] rgelt

Tipo: IWiaPropertyStorage**

Recebe o endereço de uma matriz de ponteiros de interface IWiaPropertyStorage . IEnumWIA_DEV_INFO::Next preenche essa matriz com ponteiros de interface.

[in, out] pceltFetched

Tipo: ULONG*

Na saída, esse parâmetro contém o número de ponteiros de interface realmente armazenados na matriz indicada pelo parâmetro rgelt .

Retornar valor

Tipo: HRESULT

Embora haja dispositivos para enumerar, esse método retorna S_OK. Ele retorna S_FALSE quando a enumeração é concluída. Se o método falhar, ele retornará um código de erro COM padrão.

Comentários

Os aplicativos usam esse método para consultar as propriedades de cada dispositivo de hardware WIA (Aquisição de Imagens do Windows) disponível. Para fazer isso, o aplicativo passa uma matriz de ponteiros de interface IWiaPropertyStorage que ele aloca. Ele também passa o número de elementos de matriz no celt de parâmetro. O método IEnumWIA_DEV_INFO::Next preenche a matriz com ponteiros para interfaces IWiaPropertyStorage . Os aplicativos podem consultar as interfaces para as propriedades compatíveis com o dispositivo.

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

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