IEnumOleUndoUnits：：Next 方法 (ocidl.h)

擷取列舉序列中指定的專案數目。

語法

HRESULT Next(
  [in]  ULONG        cElt,
  [out] IOleUndoUnit **rgElt,
  [out] ULONG        *pcEltFetched
);

[in] cElt

要擷取的專案數目。如果序列中剩餘的專案數目少於所要求的專案數，這個方法會擷取其餘的專案。

[out] rgElt

列舉專案的陣列。

列舉值負責呼叫 AddRef，而呼叫端負責透過列舉的每個指標呼叫 Release 。如果 cElt 大於 1，呼叫端也必須傳遞傳遞至 pcEltFetched 的非 Null 指標，以瞭解要釋放的指標數目。

[out] pcEltFetched

已擷取的專案數目。此參數一律小於或等於所要求的專案數目。

如果方法擷取所要求的專案數，傳回值會S_OK。否則，它會S_FALSE。

呼叫端負責在此方法成功傳回之後，為數組中的每個專案呼叫 Release 方法。如果 cUndoUnits 大於一，呼叫端也必須將非 Null 指標傳遞至 pcFetched，以取得它必須釋放的指標數目。

E_NOTIMPL不允許做為傳回值。如果傳回錯誤值，rgpcd 陣列中沒有任何專案在結束時有效，而且不需要釋放。