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

要求

要求
目标平台 桌面
标头 wiamdef.h (包括 Wiamdef.h)
Library Wiaservc.lib
DLL Wiaservc.dll

另请参阅

wiasWriteMultiple