IEnumOleDocumentViews::Next-Methode (docobj.h)
Ruft die angegebene Anzahl von Elementen in der Enumerationssequenz ab.
Syntax
HRESULT Next(
[in] ULONG cViews,
[out] IOleDocumentView **rgpView,
[in, out] ULONG *pcFetched
);
Parameter
[in] cViews
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.
Wenn pcFetchedNULL ist, muss dieser Parameter 1 sein.
[out] rgpView
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 cViews größer als 1 ist, muss der Aufrufer auch einen Nicht-NULL-Zeiger übergeben, der an pcFetched übergeben wird, um zu wissen, wie viele Zeiger freigegeben werden sollen.
[in, out] pcFetched
Die Anzahl der abgerufenen Elemente. Dieser Parameter ist immer kleiner oder gleich der Anzahl der angeforderten Elemente. Dieser Parameter kann NULL sein. In diesem Fall muss der cViews-Parameter 1 sein.
Rückgabewert
Wenn die -Methode die Anzahl der angeforderten Elemente abruft, wird der Rückgabewert S_OK. Andernfalls ist es S_FALSE.
Hinweise
E_NOTIMPL ist als Rückgabewert nicht zulässig. Wenn ein Fehlerwert zurückgegeben wird, sind keine Einträge im rgpView-Array gültig, und es sind keine Aufrufe von Release erforderlich.
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 | docobj.h |