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

Статья
02/07/2025

Функция 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

Поделиться через