Método IEnumWiaItem2::Next

Rellena una matriz de punteros a interfaces IWiaItem2 .

Sintaxis

HRESULT Next(
  [in]      ULONG     cElt,
  [out]     IWiaItem2 **ppIWiaItem2,
  [in, out] ULONG     *pcEltFetched
);

Parámetros

cElt [in]

Tipo: ULONG

Especifica el número de elementos de matriz de la matriz indicados por el parámetro ppIWiaItem2 .

ppIWiaItem2 [out]

Tipo: IWiaItem2**

Recibe la dirección de una matriz de punteros de interfaz IWiaItem2 . IEnumWiaItem2::Next rellena esta matriz con punteros de interfaz.

pcEltFetched [in, out]

Tipo: ULONG*

En la salida, este parámetro recibe el número de punteros de interfaz almacenados realmente en la matriz indicada por el parámetro ppIWiaItem2 . Una vez completada la enumeración, este parámetro contiene cero.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Comentarios

El sistema en tiempo de ejecución de Adquisición de imágenes de Windows (WIA) 2.0 representa dispositivos de hardware WIA 2.0 como un árbol jerárquico de objetos IWiaItem2 . Las aplicaciones usan el método IEnumWiaItem2::Next para obtener un puntero de interfaz IWiaItem2 para cada elemento de la carpeta actual del árbol de objetos IWiaItem2 de un dispositivo de hardware.

Para obtener la lista de punteros, la aplicación pasa una matriz de punteros de interfaz IWiaItem2 que asigna. También pasa el número de elementos de matriz en el parámetro cElt. El método IEnumWiaItem2::Next rellena la matriz con punteros a interfaces IWiaItem2 .

Hasta que se complete el proceso de enumeración, el método IEnumWiaItem2::Next devuelve S_OK. Cada vez que lo hace, establece el valor al que apunta pcEltFetched en el número de elementos que insertó en la matriz. Cuando IEnumWiaItem2::Next finaliza el proceso de enumerar objetos IWiaItem2 , devuelve S_FALSE y establece la ubicación de memoria a la que apunta pcEltFetched en cero.

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIWiaItem2 .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado	Wia.h
IDL	Wia.idl