wiasReadPropStr 函数 (wiamdef.h)
wiasReadPropStr 函数从 WIA 项检索字符串属性值。
语法
HRESULT wiasReadPropStr(
[in] BYTE *pWiasContext,
PROPID propid,
[out] BSTR *pbstr,
[out, optional] BSTR *pbstrOld,
BOOL bMustExist
);
参数
[in] pWiasContext
指向 WIA 项上下文的指针。
propid
指定属性标识符。
[out] pbstr
指向接收属性字符串值第一个字节的内存位置的指针。
[out, optional] pbstrOld
指向接收属性上一个值的第一个字节的内存位置的指针。 如果不需要此信息，请将此参数设置为 NULL。
bMustExist
指示属性是否必须存在。 如果设置为 TRUE，则 属性必须存在;如果设置为 FALSE，则属性不必存在。
返回值
成功后，函数返回S_OK。 如果函数失败，它将返回标准 COM 错误或Microsoft Windows SDK文档) 中所述 (WIA_ERROR_XXX错误之一。
注解
当微型驱动程序使用从此函数接收的字符串完成时，它必须解除分配用于字符串的内存。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Microsoft Windows Me 和 Windows XP 及更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 桌面 |
| 标头 | wiamdef.h (包括 Wiamdef.h) |
| Library | Wiaservc.lib |
| DLL | Wiaservc.dll |