IEnumFORMATETC::Next-Methode (objidl.h)

Ruft die angegebene Anzahl von Elementen in der Enumerationssequenz ab.

Syntax

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

Parameter

[in] celt

Die Anzahl der abzurufenden Elemente. Wenn weniger als die angeforderte Anzahl von Elementen in der Sequenz vorhanden ist, ruft diese Methode die restlichen Elemente ab.

[out] rgelt

Ein Array von aufgezählten Elementen.

Der Enumerator ist für die Zuweisung von Arbeitsspeicher verantwortlich, und der Aufrufer ist für die Freigabe verantwortlich. Wenn celt größer als 1 ist, muss der Aufrufer auch einen Nicht-NULL-Zeiger übergeben, der an pceltFetched übergeben wird, um zu wissen, wie viele Zeiger freigegeben werden sollen.

[in, out] pceltFetched

Die Anzahl der abgerufenen Elemente. Dieser Parameter ist immer kleiner oder gleich der Anzahl der angeforderten Elemente. Dieser Parameter kann NULL sein, wenn celt 1 ist.

Rückgabewert

Wenn die Methode die Anzahl der angeforderten Elemente abruft, wird der Rückgabewert S_OK. Andernfalls wird sie S_FALSE.

Anforderungen

Weitere Informationen

FORMATETC

IEnumFORMATETC