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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| IDL |
|