IEnumShellItems::Next-Methode (shobjidl_core.h)

Ruft ein Array einer oder mehrerer IShellItem-Schnittstellen 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 der rgelt-Parameter verweist.

[out] rgelt

Typ: IShellItem**

Die Adresse eines Arrays von Zeigern auf IShellItem-Schnittstellen , die das aufgezählte Element oder elemente empfangen. Die aufrufende Anwendung ist dafür verantwortlich, die IShellItem-Schnittstellen durch Aufrufen der IUnknown::Release-Methode freizugeben.

[out] pceltFetched

Typ: ULONG*

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

Rückgabewert

Typ: HRESULT-

Diese Methode kann einen dieser Werte zurückgeben.

Requirements

Siehe auch

IEnumShellItems

IShellItem