función wiasGetPropertyAttributes (wiamdef.h)

La función wiasGetPropertyAttributes recupera las marcas de acceso y los valores válidos de un conjunto de propiedades.

Sintaxis

HRESULT wiasGetPropertyAttributes(
  [in]  BYTE        *pWiasContext,
        LONG        cPropSpec,
  [in]  PROPSPEC    *pPropSpec,
        ULONG       *pulAccessFlags,
  [out] PROPVARIANT *pPropVar
);

Parámetros

[in] pWiasContext

Puntero a un contexto de elemento WIA.

cPropSpec

Especifica el número de propiedades.

[in] pPropSpec

Puntero a una estructura PROPSPEC que indica las propiedades para las que obtener valores válidos y marcas de acceso.

pulAccessFlags

Puntero a una matriz que contiene las marcas de acceso de las propiedades.

[out] pPropVar

Puntero a una matriz de estructuras de PROPVARIANT que contiene los valores válidos para las propiedades.

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 rellena cada elemento de la matriz pPropVar con una estructura PROPVARIANT que especifica los valores válidos para la propiedad correspondiente. Las propiedades con la marca de derechos de acceso WIA_PROP_NONE no tienen valores válidos para esa propiedad. El tipo de datos de los valores válidos de estas propiedades es VT_EMPTY.

Uno o varios de los atributos de propiedad WIA_PROP_Xxx y las marcas de acceso se pueden devolver en cada elemento de la matriz pulAccessFlags.

Si la propiedad tiene un intervalo de valores válidos, los valores se pueden determinar a través del parámetro pPropVar tras la finalización de esta función. El parámetro pPropVar especifica una matriz de estructuras PROPVARIANT.

Se accede a los valores enteros y de punto flotante válidos en un intervalo mediante las siguientes constantes de índice.

Índice de valor válido	Descripción
WIA_RANGE_MIN	Valor mínimo
WIA_RANGE_NOM	Valor nominal
WIA_RANGE_MAX	Valor máximo
WIA_RANGE_STEP	Valor de incremento

Se accede a los valores de lista válidos mediante las siguientes constantes de índice.

Índice de valor válido	Descripción
WIA_LIST_COUNT	Recuento de valores de lista válidos, sin contar el valor nominal
WIA_LIST_NOM	Valor nominal
WIA_LIST_VALUES	Índice al primer valor válido

Se accede a los valores de marca bit a bit válidos mediante las siguientes constantes de índice.

Índice de valor válido	Descripción
WIA_FLAG_NOM	Valor nominal
WIA_FLAG_VALUES	Todos los marcadores válidos se unen mediante un operador OR.

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