IScanProfileMgr::CreateProfile method

Creates an empty scan profile and associates it with a scanner or other Windows Image Acquisition (WIA) 2.0 item.

Syntax

HRESULT CreateProfile(
  [in]  BSTR         bstrDeviceID,
  [in]  BSTR         bstrName,
  [in]  GUID         guidCategory,
  [out] IScanProfile **ppScanProfile
);

Parameters

bstrDeviceID [in]

Type: BSTR

The ID of the device or WIA 2.0 item.

bstrName [in]

Type: BSTR

The friendly name of the new profile.

guidCategory [in]

Type: GUID

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

ppScanProfile [out]

Type: IScanProfile**

The address of a pointer to the new profile.

Return value

Type: HRESULT

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

Remarks

IScanProfileMgr::CreateProfile associates the specified device with the new scan profile.

IScanProfileMgr::CreateProfile automatically generates a GUID for the new profile. Get the GUID with GetGUID.

Use the IScanProfileMgr::Refresh method when more than one IScanProfileMgr object might be creating or deleting profiles at the same time.

Requirements

See also

IScanProfileMgr

Scan Profile Schema