IScanProfileMgr::CreateProfile-Methode

Erstellt ein leeres Scanprofil und ordnet es einem Scanner oder einem anderen Windows Image Acquisition (WIA) 2.0-Element zu.

Syntax

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

Parameter

bstrDeviceID [ In]

Typ: BSTR

Die ID des Geräts oder des WIA 2.0-Elements.

bstrName [ In]

Typ: BSTR

Der Anzeigename des neuen Profils.

guidCategory [ In]

Typ: GUID

Die GUID der Kategorie des Geräts oder WIA 2.0-Elements. Dies muss eine der WIA _ IPA _ ITEM _ CATEGORY-Konstanten sein.

ppScanProfile [ out]

Typ: IScanProfile**

Die Adresse eines Zeigers auf das neue Profil.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

IScanProfileMgr::CreateProfile ordnet das angegebene Gerät dem neuen Scanprofil zu.

IScanProfileMgr::CreateProfile generiert automatisch eine GUID für das neue Profil. Abrufen der GUID mit GetGUID

Verwenden Sie die IScanProfileMgr::Refresh-Methode, wenn mehrere IScanProfileMgr-Objekte gleichzeitig Profile erstellen oder löschen.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2008-Desktop-Apps]
Header
Scanprofilemgr.h
IDL
Scanprofiles.idl

Weitere Informationen

IScanProfileMgr

Scanprofilschema