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
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | objidl.h |