IEnumObjects::Next-Methode (shobjidl_core.h)

Ruft die nächste angegebene Anzahl und den Typ von Objekten ab.

Syntax

HRESULT Next(
  [in]            ULONG  celt,
  [in]            REFIID riid,
  [out]           void   **rgelt,
  [out, optional] ULONG  *pceltFetched
);

Parameter

[in] celt

Typ: ULONG

Die Anzahl der abzurufenden Objekte.

[in] riid

Typ: REFIID

Verweis auf die gewünschte Schnittstellen-ID.

[out] rgelt

Typ: void**

Wenn diese Methode zurückgibt, enthält den in riid angeforderten Schnittstellenzeiger.

[out, optional] pceltFetched

Typ: ULONG*

Zeiger auf einen ULONG-Wert , der, wenn diese Methode zurückgibt, die tatsächliche Anzahl der abgerufenen Objekte angibt. Dieser Wert kann NULL sein.

Rückgabewert

Typ: HRESULT

Gibt S_OK zurück, wenn die Methode die angeforderten Objekte erfolgreich abgerufen hat. Diese Methode gibt nur S_OK zurück, wenn die vollständige Anzahl der angeforderten Elemente erfolgreich abgerufen wurde.

S_FALSE gibt an, dass mehr Elemente angefordert wurden als in der Enumeration verblieben.

Anforderungen