IScanProfileMgr::CreateProfile-Methode

Artikel
06/13/2023

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 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 des 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, gibt sie S_OK zurück. 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. Rufen Sie die GUID mit GetGUID ab.

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

Anforderungen

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

Siehe auch

IScanProfileMgr
Profilschema überprüfen

Freigeben über