IEnumOleUndoUnits::Next-Methode (ocidl.h)

Ruft die angegebene Anzahl von Elementen in der Enumerationssequenz ab.

Syntax

HRESULT Next(
  [in]  ULONG        cElt,
  [out] IOleUndoUnit **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 restlichen Elemente ab.

[out] rgElt

Ein Array von aufgezählten Elementen.

Der Enumerator ist für das Aufrufen 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 wird sie S_FALSE.

Hinweise

Der Aufrufer ist dafür verantwortlich, die Release-Methode für jedes Element im Array aufzurufen, sobald diese Methode erfolgreich zurückgegeben wird. Wenn cUndoUnits größer als eins ist, muss der Aufrufer auch einen Nicht-NULL-Zeiger an pcFetched übergeben, um die Anzahl der zu freigebenden Zeiger abzurufen.

E_NOTIMPL ist als Rückgabewert nicht zulässig. Wenn ein Fehlerwert zurückgegeben wird, sind beim Beenden keine Einträge im rgpcd-Array gültig und erfordern keine Freigabe.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IEnumOleUndoUnits

IOleUndoUnit