IWiaItem2::D eleteItem-Methode

Entfernt das aktuelle IWiaItem2-Objekt aus der Objektstruktur des Geräts.

Syntax

HRESULT DeleteItem(
  [in] LONG lFlags
);

Parameter

lFlags [in]

Typ: LONG

Derzeit nicht verwendet. Sollte auf Null festgelegt werden.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Das Windows Image Acquisition (WIA) 2.0-Laufzeitsystem stellt jedes mit dem Computer des Benutzers verbundene WIA 2.0-Hardwaregerät als hierarchische Struktur von IWiaItem2-Objekten dar. Ein bestimmtes WIA 2.0-Gerät kann anwendungen das Löschen von IWiaItem2-Objekten aus seiner Struktur erlauben oder nicht. Elemente mit untergeordneten Elementen können nicht gelöscht werden. Die IEnumWIA_DEV_CAPS-Schnittstelle muss verwendet werden, um das Gerät auf die Funktion zum Löschen von Elementen abzufragen.

Wenn das Gerät das Löschen von Elementen in seiner IWiaItem2-Struktur unterstützt, rufen Sie die IWiaItem2::D eleteItem-Methode auf, um das IWiaItem2-Objekt zu entfernen. Beachten Sie, dass diese Methode ein Objekt erst löscht, nachdem alle Verweise auf das Objekt freigegeben wurden. Wenn beim Löschen eines Elements ein Fehler aufgetreten ist, wird E_DELETEITEM zurückgegeben. Der numerische Wert für diesen Fehler ist noch nicht definiert.

Anforderungen

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