IScanProfile：：SetProperty 方法

设置扫描配置文件的 元素中 <Properties> 指定子属性的值。

语法

HRESULT SetProperty(
  [in] ULONG       num,
  [in] PROPID      *pid,
  [in] PROPVARIANT *pvar
);

参数

num [in]

类型： ULONG

pid 和 pvar 指向的数组中的条目数。

pid [in]

类型： PROPID*

指向要设置的属性的标识号数组的指针。 数组中的每个值都是 WIA 属性常量。

pvar [in]

类型： PROPVARIANT*

指向要分配给属性的值数组的指针。

返回值

类型： HRESULT

如果此方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。

备注

pid 指向的数组中的每个值都是 WIA 属性常量之一。 可以扩展此标识系统。 请参阅 定义自定义属性。

在应用程序调用 IScanProfile：：Save 方法之前，不会将配置文件的更改保存到磁盘。

如果两个应用程序从同一 XML 文件创建扫描配置文件对象，并且每个应用程序将更改写入其对象，则仅将调用 IScanProfile：：Save last 的应用程序所做的更改保存到磁盘。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Scanprofile.h
IDL	Scanprofiles.idl

另请参阅

IScanProfile

概念性

扫描配置文件架构

WIA 属性常量

定义自定义属性