IWiaItem2::EnumChildItems-Methode

Erstellt ein Enumeratorobjekt und übergibt einen Zeiger auf seine IEnumWiaItem2-Schnittstelle für Ordner mit Elementen in der IWiaItem2-Struktur eines Windows WIA 2.0-Geräts (Image Acquisition).

Syntax

HRESULT EnumChildItems(
  [in]  const GUID          *pCategoryGUID,
  [out]       IEnumWiaItem2 **ppIEnumWiaItem2
);

Parameter

pCategoryGUID [ In]

Typ: const * GUID

Gibt einen Zeiger auf eine Kategorie an, für die untergeordnete Knoten aufzählt werden. Wenn NULL ist, werden alle untergeordneten Knoten aufzählt.

ppIEnumWiaItem2 [ out]

Typ: IEnumWiaItem2**

Empfängt die Adresse eines Zeigers auf die IEnumWiaItem2-Schnittstelle, die von dieser Methode erstellt wird.

Rückgabewert

Typ: HRESULT

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

Bemerkungen

Das WIA 2.0-Laufzeitsystem stellt jedes WIA 2.0-Hardwaregerät als hierarchische Struktur von IWiaItem2-Objekten dar. Mit der IWiaItem2::EnumChildItems-Methode können Anwendungen untergeordnete Elemente im aktuellen Element auflisten. Sie kann jedoch nur auf Elemente angewendet werden, die Ordner sind.

Wenn der Ordner nicht leer ist, enthält er eine Unterstruktur von IWiaItem2-Objekten. Die IWiaItem2::EnumChildItems-Methode listet alle elemente auf, die im Ordner enthalten sind. Es speichert einen Zeiger auf einen Enumerator im ppIEnumWiaItem2-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 ppIEnumWiaItem2-Parameter empfangen.

Requirements (Anforderungen)

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