IEnumUnknown::Next-Methode (objidlbase.h)
Ruft die angegebene Anzahl von Elementen in der Enumerationssequenz ab.
Syntax
HRESULT Next(
[in] ULONG celt,
[out] IUnknown **rgelt,
[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 verbleibenden Elemente ab.
[out] rgelt
Ein Array von enumerierten Elementen.
Der Enumerator ist für den Aufruf von AddRef verantwortlich, und der Aufrufer ist für den Aufruf von Release über jeden aufgezählten Zeiger 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.
[out] pceltFetched
Die Anzahl der abgerufenen Elemente. Dieser Parameter ist immer kleiner oder gleich der Anzahl der angeforderten Elemente.
Rückgabewert
Wenn die -Methode die Anzahl der angeforderten Elemente abruft, wird der Rückgabewert S_OK. Andernfalls ist es S_FALSE.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidlbase.h (include ObjIdl.h) |