IScanProfile 接口

IScanProfile 接口表示单个扫描配置文件，使应用程序能够设置和获取配置文件的属性。

成员

IScanProfile 接口继承自 IDispatch 接口。 IScanProfile 还具有以下类型的成员：

• 方法

方法

IScanProfile 接口包含以下方法。

方法	说明
GetAllPropIDs	获取配置文件中的所有可用属性 ID。
GetDeviceID	返回设备的 ID。
GetGUID	返回配置文件的 GUID。
GetItem	获取与配置文件关联的 WIA 2.0 项类别的 GUID。
GetName	获取配置文件的友好名称。
GetNumPropIDS	获取配置文件中属性 ID 的数目。
GetProperty	获取扫描配置文件的 元素中 <Properties> 指定子属性的值。
IsDefault	获取一个值，该值指示配置文件是否为关联 IWiaItem2 设备的默认扫描配置文件。
RemoveProperty	删除扫描配置文件的 元素中的 <Properties> 指定子属性列表。
保存	将配置文件的更改保存到磁盘。
SetItem	设置与配置文件关联的 WIA 2.0 项类别的 GUID。
SetName	设置配置文件的友好名称。
SetProperty	设置扫描配置文件的 元素中 <Properties> 指定子属性的值。

 

备注

任何 IWiaItem2 设备都可以具有扫描配置文件。 但是，WIA_CATEGORY_FINISHED_FILE和WIA_CATEGORY_ROOT类型的 IWiaItem2 项不能具有配置文件。

如果使用 IScanProfile：：Save 方法保存扫描配置文件，则会将其作为 XML 文件存储在 %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles 中。

若要创建 IScanProfile 对象的实例，请使用 IScanProfileMgr：：CreateProfile 方法。 若要获取对已保存到磁盘的扫描配置文件的引用，请使用 IScanProfileMgr：：OpenProfile 方法。

所有扫描配置文件都具有以下元素： <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>、 和 <Properties>。 设备的默认配置文件还具有 <Default> 元素。

<ProfileGUID>创建配置文件后，无法更改 和 <DeviceID> 元素。 创建配置文件后，<WiaItem>可以更改 元素和 元素的值<ProfileName>。 <Default>可以添加或删除 元素。 这可以通过 IScanProfile：：SetName、 IScanProfile：：SetItem 和 IScanProfileMgr：：SetDefault 方法以编程方式完成。 用户还可以通过 IScanProfileUI：：ScanProfileDialog 方法更改这些属性。

元素 <Properties> 包含子元素 <Property> 。 使用这些属性将任何 WIA 2.0 项或设备属性添加到配置文件。 你还可以开发自己的图像获取 <Property> 子级。 这使得扫描配置文件架构可扩展。 (有关扩展架构的详细信息，请参阅 定义自定义属性、 IScanProfile：：GetProperty 和 IScanProfile：：SetProperty.)

要求

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

另请参阅

IDispatch

扫描配置文件架构