IWiaItem2::EnumChildItems-Methode

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

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 aufgelistet werden. Wenn NULL, werden alle untergeordneten Knoten aufgelistet.

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, gibt sie S_OK zurück. 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. Es 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.

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