wiasSetPropertyAttributes 函数 (wiamdef.h)

wiasSetPropertyAttributes 函数设置一组属性的访问标志和有效值。

语法

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

参数

[in] pWiasContext

指向 WIA 项上下文的指针。

cPropSpec

指定属性数。

[in] pPropSpec

指向 PROPSPEC 结构的指针,该结构指示要为其设置有效值和访问标志的属性。

[in] pulAccessFlags

指向包含要写入的访问标志的数组的指针。

[out] pPropVar

指向包含要写入的有效值的 PROPVARIANT 结构的数组的指针。

返回值

成功后,该函数将返回S_OK。 如果函数失败,它将返回标准 COM 错误或WIA_ERROR_XXX错误之一(Microsoft Windows SDK 文档中所述)。

言论

微型驱动程序应使用函数 wiasSetItemPropAttribs 初始化简单属性组。

微型驱动程序可以在一段时间内不更改的属性上设置WIA_PROP_CACHEABLE标志。 通过在属性上设置此标志,微型驱动程序指示 WIA 服务可以缓存属性值。 有关所有属性属性的列表,请参阅 Windows SDK 文档。

PROPSPEC 和 PROPVARIANT 结构在 Windows SDK 文档中定义。

要求

要求 价值
最低支持的客户端 Microsoft Windows Me 和 Windows XP 及更高版本的 Windows作系统中提供。
目标平台 桌面
标头 wiamdef.h (包括 Wiamdef.h)
Wiaservc.lib
DLL Wiaservc.dll

另请参阅

wiasSetItemPropAttribs