IEnumWiaItem::Next-Methode (wia_xp.h)

Artikel
03/03/2024

Die IEnumWiaItem::Next-Methode füllt ein Array von Zeigern auf IWiaItem-Schnittstellen aus.

Syntax

HRESULT Next(
  [in]      ULONG    celt,
  [out]     IWiaItem **ppIWiaItem,
  [in, out] ULONG    *pceltFetched
);

Parameter

[in] celt

Typ: ULONG

Gibt die Anzahl der Arrayelemente in dem Array an, die durch den ppIWiaItem-Parameter angegeben wird.

[out] ppIWiaItem

Typ: IWiaItem**

Empfängt die Adresse eines Arrays von IWiaItem-Schnittstellenzeigern . IEnumWiaItem::Next füllt dieses Array mit Schnittstellenzeigern aus.

[in, out] pceltFetched

Typ: ULONG*

Bei der Ausgabe empfängt dieser Parameter die Anzahl von Schnittstellenzeigern, die tatsächlich in dem Array gespeichert sind, das durch den ppIWiaItem-Parameter angegeben ist . Wenn die Enumeration abgeschlossen ist, enthält dieser Parameter null.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück. Wenn die Enumeration abgeschlossen ist, gibt sie S_FALSE zurück. Wenn die Methode fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.

Hinweise

Das Windows Image Acquisition (WIA)-Laufzeitsystem stellt WIA-Hardwaregeräte als hierarchische Struktur von IWiaItem-Objekten dar. Anwendungen verwenden die IEnumWiaItem::Next-Methode , um einen IWiaItem-Schnittstellenzeiger für jedes Element im aktuellen Ordner der IWiaItem-Objektstruktur eines Hardwaregeräts abzurufen.

Um die Liste der Zeiger abzurufen, übergibt die Anwendung ein Array von IWiaItem-Schnittstellenzeigern , das sie zuordnet. Außerdem wird die Anzahl der Arrayelemente im celt-Parameter übergeben. Die IEnumWiaItem::Next-Methode füllt das Array mit Zeigern auf IWiaItem-Schnittstellen .

Bis der Enumerationsprozess abgeschlossen ist, gibt die IEnumWiaItem::Next-Methode S_OK zurück. Jedes Mal legt er den Wert, auf den von pceltFetched verwiesen wird, auf die Anzahl der Elemente festgelegt, die in das Array eingefügt wurden. Wenn IEnumWiaItem::Next den Prozess der Aufzählung von IWiaItem-Objekten abgeschlossen hat, wird S_FALSE zurückgegeben und der Speicherspeicherort, auf den von pceltFetched verwiesen wird, auf 0 festgelegt.

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

Anforderungen

Anforderung	Wert
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 (einschließlich Wia.h)
Bibliothek	Wiaguid.lib

Freigeben über