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 [仅限桌面应用] |
标头 |
|
IDL |
|
另请参阅