Функция wiasGetPropertyAttributes (wiamdef.h)

Функция wiasGetPropertyAttributes извлекает флаги доступа и допустимые значения для набора свойств.

Синтаксис

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

Параметры

[in] pWiasContext

Указатель на контекст элемента WIA.

cPropSpec

Указывает количество свойств.

[in] pPropSpec

Указатель на структуру PROPSPEC , указывающую свойства, для которых требуется получить допустимые значения и флаги доступа.

pulAccessFlags

Указатель на массив, содержащий флаги доступа для свойств.

[out] pPropVar

Указатель на массив структур PROPVARIANT , содержащий допустимые значения для свойств.

Возвращаемое значение

При успешном выполнении функция возвращает S_OK.

Если функция завершается сбоем, она возвращает стандартную ошибку COM или один из кодов ошибок WIA.

Комментарии

Эта функция заполняет каждый элемент массива pPropVar структурой PROPVARIANT, указывающей допустимые значения для соответствующего свойства. Свойства с флагом прав доступа WIA_PROP_NONE не имеют допустимых значений для этого свойства. Тип данных для допустимых значений этих свойств — VT_EMPTY.

Один или несколько атрибутов свойства WIA_PROP_Xxx и флагов доступа можно вернуть в каждом элементе массива pulAccessFlags .

Если свойство имеет диапазон допустимых значений, значения можно определить с помощью параметра pPropVar после завершения этой функции. Параметр pPropVar указывает массив структур PROPVARIANT.

Доступ к допустимым целочисленным значениям и значениям с плавающей запятой в диапазоне можно получить с помощью следующих констант индекса.

Допустимый индекс значения	Описание
WIA_RANGE_MIN	Минимальное значение
WIA_RANGE_NOM	Номинальное значение
WIA_RANGE_MAX	Максимальное значение
WIA_RANGE_STEP	Значение приращения

Доступ к допустимым значениям списка можно получить с помощью следующих констант индекса.

Допустимый индекс значения	Описание
WIA_LIST_COUNT	Количество допустимых значений списка, не считая номинального значения
WIA_LIST_NOM	Номинальное значение
WIA_LIST_VALUES	Индексирование до первого допустимого значения

Доступ к допустимым значениям побитового флага можно получить с помощью следующих констант индекса.

Допустимый индекс значения	Описание
WIA_FLAG_NOM	Номинальное значение
WIA_FLAG_VALUES	Все допустимые флаги объединяются оператором OR

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	wiamdef.h (включая Wiamdef.h)
Библиотека	Wiaservc.lib
DLL	Wiaservc.dll