通过

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）
库 Wiaservc.lib
DLL Wiaservc.dll