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 von pid und pvar verwiesen wird.

pid [ In]

Typ: PROPID *

Ein Zeiger auf ein Array von Identifikationsnummern der eigenschaften, die festgelegt werden sollen. Jeder Wert im Array ist eine WIA-Eigenschaftskonst constants.

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, wird S _ OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Jeder Wert im Array, auf den pid zeigt, ist eine der WIA-Eigenschaftskonst constants. Sie können dieses Identifikationssystem erweitern. Weitere Informationen finden Sie unter Definieren benutzerdefinierter 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 Änderungen auf dem Datenträger gespeichert, die von der Anwendung vorgenommen wurden, die IScanProfile::Save last aufruft.

Anforderungen

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

Siehe auch

IScanProfile

Konzept

Scan Profile Schema

WIA-Eigenschaftenkonst constants

Definieren benutzerdefinierter Eigenschaften