IWiaItem::EnumChildItems-Methode (wia_xp.h)

Artikel
08/27/2023

Die IWiaItem::EnumChildItems-Methode erstellt ein Enumeratorobjekt und übergibt einen Zeiger an die IEnumWiaItem-Schnittstelle für nicht leere Ordner in einer IWiaItem-Struktur eines Wia-Geräts (Windows Image Acquisition).

Syntax

HRESULT EnumChildItems(
  [out] IEnumWiaItem **ppIEnumWiaItem
);

Parameter

[out] ppIEnumWiaItem

Typ: IEnumWiaItem**

Empfängt die Adresse eines Zeigers auf die IEnumWiaItem-Schnittstelle , die IWiaItem::EnumChildItems erstellt.

Rückgabewert

Typ: HRESULT

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

Hinweise

Das WIA-Laufzeitsystem stellt jedes WIA-Hardwaregerät als hierarchische Struktur von IWiaItem-Objekten dar. Mit der IWiaItem::EnumChildItems-Methode können Anwendungen untergeordnete Elemente im aktuellen Element auflisten. Sie kann jedoch nur auf Elemente angewendet werden, bei denen es sich um Ordner handelt.

Wenn der Ordner nicht leer ist, enthält er eine Unterstruktur von IWiaItem-Objekten . Die IWiaItem::EnumChildItems-Methode listet alle elemente auf, die im Ordner enthalten sind. Es speichert einen Zeiger auf einen Enumerator im ppIEnumWiaItem-Parameter . Anwendungen verwenden den Enumeratorzeiger, um die Enumeration der untergeordneten Elemente eines Objekts auszuführen.

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den ppIEnumWiaItem-Parameter empfangen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wia_xp.h (wia.h einschließen)
Bibliothek	Wiaguid.lib
DLL	Wiaservc.dll

Freigeben über