IEnumWiaItem2::Next-Methode

Füllt ein Array von Zeigern auf IWiaItem2-Schnittstellen aus.

Syntax

HRESULT Next(
  [in]      ULONG     cElt,
  [out]     IWiaItem2 **ppIWiaItem2,
  [in, out] ULONG     *pcEltFetched
);

Parameter

cElt [in]

Typ: ULONG

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

ppIWiaItem2 [out]

Typ: IWiaItem2**

Empfängt die Adresse eines Arrays von IWiaItem2-Schnittstellenzeigern . IEnumWiaItem2::Next füllt dieses Array mit Schnittstellenzeigern.

pcEltFetched [ein, aus]

Typ: ULONG*

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

Rückgabewert

Typ: HRESULT

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

Bemerkungen

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

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

Bis der Enumerationsprozess abgeschlossen ist, gibt die IEnumWiaItem2::Next-Methode S_OK zurück. Jedes Mal wird der Wert festgelegt, auf den von pcEltFetched verwiesen wird, auf die Anzahl der Elemente, die in das Array eingefügt wurden. Wenn IEnumWiaItem2::Next den Vorgang zum Auflisten von IWiaItem2-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 ppIWiaItem2-Parameter empfangen.

Anforderungen