IEnumOleDocumentViews：：Next 方法 (docobj.h)

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

語法

HRESULT Next(
  [in]      ULONG            cViews,
  [out]     IOleDocumentView **rgpView,
  [in, out] ULONG            *pcFetched
);

參數

[in] cViews

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

如果 pcFetched 為 NULL，此參數必須為 1。

[out] rgpView

列舉項目的陣列。

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

[in, out] pcFetched

已擷取的項目數。 此參數一律小於或等於所要求的項目數目。 此參數可以是 NULL，在此情況下 ，cViews 參數必須是 1。

傳回值

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

備註

E_NOTIMPL不允許作為傳回值。 如果傳回錯誤值， 則 rgpView 陣列中沒有任何專案有效，而且不需要呼叫 Release。

規格需求

另請參閱

IEnumOleDocumentViews

IOleDocumentView