Freigeben über


IScanProfile::SetProperty-Methode

Legt den Wert der angegebenen untergeordneten Eigenschaften im <Properties> Element eines Scanprofils fest.

Syntax

HRESULT SetProperty(
  [in] ULONG       num,
  [in] PROPID      *pid,
  [in] PROPVARIANT *pvar
);

Parameter

num [in]

Typ: ULONG

Die Anzahl der Einträge in den Arrays, auf die durch pid und pvar verwiesen wird.

pid [in]

Typ: PROPID*

Ein Zeiger auf ein Array von Identifikationsnummern der festzulegenden Eigenschaften. Jeder Wert im Array ist eine WIA-Eigenschaftskonstante.

pvar [in]

Typ: PROPVARIANT*

Ein Zeiger auf ein Array von Werten, die den Eigenschaften zugewiesen werden sollen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Jeder Wert im Array, auf das pid verweist, ist eine der WIA-Eigenschaftskonstanten. Sie können dieses Identifikationssystem erweitern. Weitere Informationen finden Sie unter Definieren von benutzerdefinierten Eigenschaften.

Änderungen an einem Profil werden erst auf dem Datenträger gespeichert, wenn die Anwendung die IScanProfile::Save-Methode aufruft.

Wenn zwei Anwendungen Scanprofilobjekte aus derselben XML-Datei erstellen und jede Anwendung Änderungen in ihr Objekt schreibt, werden nur die Von der Anwendung vorgenommenen Änderungen, die IScanProfile::Zuletzt speichern , auf dem Datenträger gespeichert.

Anforderungen

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

Siehe auch

IScanProfile

Konzept

Profilschema überprüfen

WIA-Eigenschaftskonstanten

Definieren benutzerdefinierter Eigenschaften