IEnumOleDocumentViews::Next-Methode (docobj.h)

  • Artikel

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

Weitere Informationen

IEnumOleDocumentViews

IOleDocumentView