wiasReadMultiple 函数 (wiamdef.h)

wiasReadMultiple 函数从 WIA 项检索多个属性值。

语法

HRESULT wiasReadMultiple(
  [in]            BYTE           *pWiasContext,
                  ULONG          ulCount,
  [in]            const PROPSPEC *ps,
  [out]           PROPVARIANT    *pv,
  [out, optional] PROPVARIANT    *pvOld
);

参数

[in] pWiasContext

指向 WIA 项上下文的指针。

ulCount

指定要读取的属性数。

[in] ps

指向 PROPSPEC 结构数组的第一个元素的指针，其中包含要读取的属性。

[out] pv

指向 PROPVARIANT 结构数组的第一个元素的指针。 返回时，这些结构包含属性的新值。

[out, optional] pvOld

指向之前由微型驱动程序分配的 PROPVARIANT 结构数组的第一个元素的指针。 返回时，数组包含属性数据的先前值。 如果不需要此信息，则可以将此参数设置为 NULL。

返回值

成功后，函数返回S_OK。

如果函数失败，它将返回标准 COM 错误或 WIA 错误代码之一。

注解

此函数从 WIA 项读取多个属性。 调用成功后，微型驱动程序必须对 pv 参数指定的数组中的每个元素调用 PropVariantClear。 有关详细信息 ，请参阅 IPropertyStorage：：ReadMultiple 。

要求

另请参阅

wiasWriteMultiple