IScanProfile::Save 方法

将配置文件的更改保存到磁盘。

语法

HRESULT Save();

参数

此方法没有任何参数。

返回值

类型: HRESULT

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

备注

保存的扫描配置文件是存储在 %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles 中的 XML 文件。

如果多个进程写入 IScanProfile 对象,则调用 IScanProfile::Save last 的进程是唯一保存更改的进程。

IScanProfile::Save 方法在保存之前验证配置文件。 除非与配置文件关联的 Windows 映像获取 (WIA) 2.0 项的类别WIA_CATEGORY_FLATBED或WIA_CATEGORY_FEEDER,否则配置文件始终被视为有效。 如果类别WIA_CATEGORY_FLATBED或WIA_CATEGORY_FEEDER,则以下属性必须对项有效(如果属性包含在配置文件中):

WIA_IPS_BRIGHTNESS

WIA_IPS_CONTRAST

WIA_IPA_DATATYPE

WIA_IPS_XRES

WIA_IPA_FORMAT

此外,如果类别WIA_CATEGORY_FEEDER,则 WIA_IPS_PAGE_SIZE 属性必须有效(如果配置文件中存在)。 有关这些属性的详细信息,请参阅 扫描程序 WIA 项属性常量

要求

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

另请参阅

IScanProfile

扫描配置文件架构