IEnumShellItems::Next-Methode (shobjidl_core.h)

Artikel
03/02/2024

Ruft ein Array von mindestens einer IShellItem-Schnittstelle aus der Enumeration ab.

Syntax

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

Parameter

[in] celt

Typ: ULONG

Die Anzahl der Elemente im Array, auf die vom rgelt-Parameter verwiesen wird .

[out] rgelt

Typ: IShellItem**

Die Adresse eines Arrays von Zeigern auf IShellItem-Schnittstellen , die das oder die aufgelisteten Elemente empfangen. Die aufrufende Anwendung ist für das Freigeben der IShellItem-Schnittstellen durch Aufrufen der IUnknown::Release-Methode verantwortlich.

[out] pceltFetched

Typ: ULONG*

Ein Zeiger auf einen Wert, der die Anzahl der erfolgreich abgerufenen IShellItem-Schnittstellen empfängt. Die Anzahl kann kleiner als der im celt-Parameter angegebene Wert sein. Dieser Parameter kann beim Eintrag nur NULL sein, wenn celt eins ist, da die Methode in diesem Fall nur ein Element abrufen und S_OK oder null Elemente zurückgeben kann und S_FALSE zurückgibt.

Rückgabewert

Typ: HRESULT

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	, wenn mindestens die IShellItem-Schnittstelle abgerufen wurde.
S_FALSE	, wenn keine weiteren IShellItem-Schnittstellen in der Enumeration vorhanden sind.
	Gibt einen Fehlerwert zurück, wenn die Funktion aus einem anderen Grund fehlschlägt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

IEnumShellItems

IShellItem

Freigeben über