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 错误代码之一。

注解

此函数使用 PROPVARIANT 结构填充 pPropVar 数组的每个元素，该结构指定相应属性的有效值。 具有访问权限标志WIA_PROP_NONE的属性没有该属性的有效值。 这些属性的有效值的数据类型VT_EMPTY。

可以在 pulAccessFlags 数组的每个元素中返回一个或多个WIA_PROP_Xxx属性和访问标志。

如果 属性具有一系列有效值，则完成此函数后，可以通过 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)
Library	Wiaservc.lib
DLL	Wiaservc.dll