IEnumContextProps::Next-Methode (objidl.h)
Ruft die angegebene Anzahl von Elementen in der Enumerationssequenz ab.
Syntax
HRESULT Next(
[in] ULONG celt,
[out] ContextProperty *pContextProperties,
[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] pContextProperties
Ein Array von enumerierten 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.
[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 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h (include ObjIdl.h) |