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)
Wiaservc.lib
DLL Wiaservc.dll

另请参阅

wiasReadPropFloat

wiasReadPropGuid

wiasReadPropLong

wiasReadPropStr

wiasWritePropBin