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 |
|
| IDL |
|