Compartir a través de

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

  • Artículo

El método IEnumWiaItem::Next rellena una matriz de punteros a interfaces IWiaItem .

Sintaxis

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

Parámetros

[in] celt

Tipo: ULONG

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

[out] ppIWiaItem

Tipo: IWiaItem**

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

[in, out] pceltFetched

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 ppIWiaItem . Una vez completada la enumeración, este parámetro contendrá cero.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el método devuelve S_OK. Una vez completada la enumeración, devuelve S_FALSE. Si se produce un error en el método, devuelve un código de error COM estándar.

Comentarios

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

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

Hasta que se complete el proceso de enumeración, el método IEnumWiaItem::Next devuelve S_OK. Cada vez que lo hace, establece el valor al que apunta pceltFetched al número de elementos que insertó en la matriz. Cuando IEnumWiaItem::Next finaliza el proceso de enumerar objetos IWiaItem , 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 ppIWiaItem .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluya Wia.h)
Library Wiaguid.lib