Función wiasReadMultiple (wiamdef.h)

La función wiasReadMultiple recupera varios valores de propiedad de un elemento WIA.

Sintaxis

HRESULT wiasReadMultiple(
  [in]            BYTE           *pWiasContext,
                  ULONG          ulCount,
  [in]            const PROPSPEC *ps,
  [out]           PROPVARIANT    *pv,
  [out, optional] PROPVARIANT    *pvOld
);

Parámetros

[in] pWiasContext

Puntero a un contexto de elemento WIA.

ulCount

Especifica el número de propiedades que se van a leer.

[in] ps

Puntero al primer elemento de una matriz de estructuras PROPSPEC, que contiene las propiedades que se van a leer.

[out] pv

Puntero al primer elemento de una matriz de estructuras PROPVARIANT. Tras la devolución, estas estructuras contienen nuevos valores para las propiedades.

[out, optional] pvOld

Puntero al primer elemento de una matriz de estructuras PROPVARIANT asignadas previamente por el minidriver. Tras la devolución, la matriz contiene los valores anteriores de los datos de propiedad. Si no se necesita esta información, este parámetro se puede establecer en NULL.

Valor devuelto

Si la función se ejecuta correctamente, devuelve S_OK.

Si se produce un error en la función, devuelve un error COM estándar o uno de los códigos de error WIA.

Observaciones

Esta función lee varias propiedades de un elemento WIA. Cuando la llamada se realiza correctamente, el minidriver debe llamar a PropVariantClear en cada elemento de la matriz especificada por el parámetro pv. Consulte IPropertyStorage::ReadMultiple para obtener más información.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	wiamdef.h (incluya Wiamdef.h)
biblioteca de	Wiaservc.lib
DLL de	Wiaservc.dll

Consulte también

wiasWriteMultiple