Export (0) Print
Expand All

IScanProfile interface

The IScanProfile interface represents a single scan profile and enables applications to set and get the properties of the profile.

Members

The IScanProfile interface inherits from the IDispatch interface. IScanProfile also has these types of members:

Methods

The IScanProfile interface has these methods.

MethodDescription
GetAllPropIDs

Gets all available property IDs in a profile.

GetDeviceID

Returns the ID of the device.

GetGUID

Returns the GUID of the profile.

GetItem

Gets the GUID of the category of the WIA 2.0 item that the profile is associated with.

GetName

Gets the friendly name of the profile.

GetNumPropIDS

Gets the number of property IDs in a profile.

GetProperty

Gets the value of specified child properties in the <Properties> element of a scan profile.

IsDefault

Gets a value that indicates whether the profile is the default scan profile of an associated IWiaItem2 device.

RemoveProperty

Removes a specified list of child properties in the <Properties> element of a scan profile.

Save

Saves changes to a profile to disk.

SetItem

Sets the GUID of the category of WIA 2.0 item that the profile is associated with.

SetName

Sets the friendly name of the profile.

SetProperty

Sets the value of specified child properties in the <Properties> element of a scan profile.

 

Remarks

Any IWiaItem2 device can have a scan profile. However, IWiaItem2 items of types WIA_CATEGORY_FINISHED_FILE and WIA_CATEGORY_ROOT cannot have profiles.

If a scan profile is saved using the IScanProfile::Save method, it is stored as an XML file at %USERPROFILE%\Application Data\Microsoft\Document Center\UserScanProfiles.

To create an instance of an IScanProfile object, use the IScanProfileMgr::CreateProfile method. To get a reference to a scan profile that has already been saved to disk, use the IScanProfileMgr::OpenProfile method.

All scan profiles have the following elements: <ProfileGUID>, <DeviceID>, <ProfileName>, <WiaItem>, and <Properties>. The default profile of a device also has a <Default> element.

The <ProfileGUID> and <DeviceID> elements cannot be changed after the profile is created. The values of the <ProfileName> element and the <WiaItem> element can be changed after the profile is created. The <Default> element can be added or deleted. This can be done programatically with the IScanProfile::SetName, IScanProfile::SetItem, and IScanProfileMgr::SetDefault methods. These properties can also be changed by users through the IScanProfileUI::ScanProfileDialog method.

The <Properties> element contains <Property> children. Use these to add any WIA 2.0 item or device property to the profile. You can also develop your own image acquistion <Property> children. This makes the Scan Profile Schema extensible. (For more information about extending the schema, see Defining Custom Properties, IScanProfile::GetProperty, and IScanProfile::SetProperty.)

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

IDL

Scanprofiles.idl

See also

Scan Profile Schema

 

 

Community Additions

ADD
Show:
© 2014 Microsoft