IScanProfile::SetItem method

Sets the GUID of the category of Windows Image Acquisition (WIA) 2.0 item that the profile is associated with.

Syntax

HRESULT SetItem(
  [in] GUID guidCategory
);

Parameters

guidCategory [in]

Type: GUID

The GUID of the category of the WIA 2.0 item. This must be one of the WIA_IPA_ITEM_CATEGORY constants.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Users can change the category with the ScanProfileDialog method.

Changes to a profile are not saved to disk until the application calls the IScanProfile::Save method.

If two applications create scan profile objects from the same XML file, and each application writes changes to its object, only the changes made by the application that calls IScanProfile::Save last are saved to disk.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Header
Scanprofile.h
IDL
Scanprofiles.idl

See also

IScanProfile

Scan Profile Schema