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

Статья
02/07/2025

Функция wiasValidateItemProperties проверяет список простых свойств элемента в отношении текущих допустимых значений.

Синтаксис

HRESULT wiasValidateItemProperties(
  [in] BYTE           *pWiasContext,
       ULONG          nPropSpec,
  [in] const PROPSPEC *pPropSpec
);

Параметры

[in] pWiasContext

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

nPropSpec

Указывает количество свойств для проверки.

[in] pPropSpec

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

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

При успешном выполнении функция возвращает S_OK. Если функция завершается ошибкой, она возвращает стандартную ошибку COM или одну из WIA_ERROR_XXX ошибок (описанную в документации по пакету SDK для Microsoft Windows).

Замечания

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

Атрибуты	Поддерживаемые типы
WIA_PROP_FLAG	VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4
WIA_PROP_RANGE	VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, VT_R4, VT_R8
WIA_PROP_LIST	VT_UI1, VT_UI2, VT_UI4, VT_UI8, VT_I1, VT_I2, VT_I4, VT_R4, VT_R8, VT_BSTR

Структура PROPSPEC определена в документации по пакету SDK для Windows.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Microsoft Windows Me и Windows XP и более поздних версиях операционных систем Windows.
целевая платформа	Настольный
заголовка	wiamdef.h (включая Wiamdef.h)
библиотеки	Wiaservc.lib
DLL	Wiaservc.dll

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