wiasGetChangedValueStr 函数 (wiamdef.h)

wiasGetChangedValueStr 函数确定具有字符串值的属性是否已由应用程序更改。

语法

HRESULT wiasGetChangedValueStr(
  [in] BYTE                    *pWiasContext,
  [in] WIA_PROPERTY_CONTEXT    *pContext,
       BOOL                    bNoValidation,
       PROPID                  propID,
       WIAS_CHANGED_VALUE_INFO *pInfo
);

参数

[in] pWiasContext

指向 WIA 项上下文的指针。

[in] pContext

指向包含当前属性上下文 的WIA_PROPERTY_CONTEXT 结构的指针。

bNoValidation

指示是否应根据属性的有效值集验证该属性的当前值。 如果此参数设置为 TRUE,则函数不会对属性执行验证。 如果为 FALSE,则函数执行数据验证。

propID

指定要测试的属性的属性标识符。

pInfo

指向包含属性的当前值和上一个值的 WIAS_CHANGED_VALUE_INFO 结构的指针。

返回值

成功后,该函数将返回S_OK。

如果函数失败,它将返回标准 COM 错误或 WIA 错误代码之一。

注解

驱动程序应仅在驱动程序更新属性的值后验证该属性。 驱动程序根据应用程序请求的属性更改更新值。

要求

   
目标平台 桌面
Header wiamdef.h (包括 Wiamdef.h)
Library Wiaservc.lib
DLL Wiaservc.dll

另请参阅

WIAS_CHANGED_VALUE_INFO

WIA_PROPERTY_CONTEXT

wiasGetChangedValueFloat

wiasGetChangedValueGuid

wiasGetChangedValueLong