wiasReadPropGuid 函数 (wiamdef.h)

wiasReadPropGuid 函数从 WIA 项检索 GUID 属性值。

语法

HRESULT wiasReadPropGuid(
  [in]            BYTE   *pWiasContext,
                  PROPID propid,
  [out]           GUID   *pguidVal,
  [out, optional] GUID   *pguidValOld,
                  BOOL   bMustExist
);

参数

[in] pWiasContext

指向 WIA 项上下文的指针。

propid

指定属性标识符。

[out] pguidVal

指向接收 GUID 属性值的内存位置的指针。

[out, optional] pguidValOld

指向接收 GUID 属性数据的先前值的内存位置的指针。 如果不需要此信息,可将此参数设置为 NULL

bMustExist

指示属性是否必须存在。 如果设置为 TRUE,则属性必须存在;如果设置为 FALSE,则属性不必存在。

返回值

成功后,该函数将返回S_OK。 如果函数失败,它将返回标准 COM 错误或WIA_ERROR_XXX错误之一(Microsoft Windows SDK 文档中所述)。

要求

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

另请参阅

wiasReadPropBin

wiasReadPropFloat

wiasReadPropLong

wiasReadPropStr

wiasWritePropGuid