wiasReadPropBin 函数 (wiamdef.h)
wiasReadPropBin 函数从 WIA 项检索二进制数据属性值。
语法
HRESULT wiasReadPropBin(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BYTE **ppbVal,
[out, optional] BYTE **ppbValOld,
BOOL bMustExist
);
参数
[in] pWiasContext
指向 WIA 项上下文的指针。
propid
指定属性标识符。
[out] ppbVal
指向内存位置的指针，该位置接收此函数分配的缓冲区的地址。 返回时，缓冲区包含属性的二进制数据。
[out, optional] ppbValOld
指向内存位置的指针，该位置接收微型驱动程序分配的缓冲区的地址。 返回后，缓冲区包含属性的二进制数据的上一个值。 如果不需要此信息，则可以将此参数设置为 NULL。
bMustExist
指示属性是否必须存在。 如果设置为 TRUE，则 属性必须存在;如果设置为 FALSE，则属性不必存在。
返回值
成功后，函数返回S_OK。
如果函数失败，它将返回标准 COM 错误或 WIA 错误代码之一。
注解
此函数分配缓冲区并将其地址存储在 ppbVal 参数中。 微型驱动程序必须通过调用 CoTaskMemFree 来释放缓冲区。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | wiamdef.h (包括 Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL | Wiaservc.dll |