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 |