IEnumWIA_DEV_INFO::Next-Methode (wia_xp.h)

Artikel
03/06/2024

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

Syntax

HRESULT Next(
  [in]      ULONG               celt,
  [out]     IWiaPropertyStorage **rgelt,
  [in, out] ULONG               *pceltFetched
);

Parameter

[in] celt

Typ: ULONG

Gibt die Anzahl der Arrayelemente im Array an, die durch den rgelt-Parameter angegeben wird.

[out] rgelt

Typ: IWiaPropertyStorage**

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

[in, out] pceltFetched

Typ: ULONG*

Bei der Ausgabe enthält dieser Parameter die Anzahl der Schnittstellenzeiger, die tatsächlich in dem vom rgelt-Parameter angegebenen Array gespeichert sind.

Rückgabewert

Typ: HRESULT

Während es noch Geräte gibt, die aufgelistet werden müssen, gibt diese Methode S_OK zurück. Sie gibt S_FALSE zurück, wenn die Enumeration abgeschlossen ist. Wenn die Methode fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.

Hinweise

Anwendungen verwenden diese Methode, um die Eigenschaften jedes verfügbaren Windows Image Acquisition (WIA)-Hardwaregeräts abzufragen. Dazu übergibt die Anwendung ein Array von IWiaPropertyStorage-Schnittstellenzeigern , die sie ordnet. Außerdem wird die Anzahl der Arrayelemente im Parameter celt übergeben. Die IEnumWIA_DEV_INFO::Next-Methode füllt das Array mit Zeigern auf IWiaPropertyStorage-Schnittstellen . Anwendungen können die Schnittstellen für die vom Gerät unterstützten Eigenschaften abfragen.

Anwendungen müssen die IUnknown::Release-Methode für die Schnittstellenzeiger aufrufen, die sie über den rgelt-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