Freigeben über


IScanProfile::RemoveProperty-Methode

Entfernt eine angegebene Liste der untergeordneten Eigenschaften im <Properties> Element eines Überprüfungsprofils.

Syntax

HRESULT RemoveProperty(
  [in] ULONG  num,
  [in] PROPID *pid
);

Parameter

num [in]

Typ: ULONG

Die Anzahl der Einträge im Array, auf das pid verweist .

pid [in]

Typ: PROPID*

Ein Zeiger auf ein Array von Identifikationsnummern der zu löschenden Eigenschaften. Jede ist eine WIA-Eigenschaftskonstanten.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. 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::Save zuletzt aufruft, 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

Scanprofilschema

WIA-Eigenschaftskonstanten

Definieren benutzerdefinierter Eigenschaften