Contents Index Topic Contents
	Previous Topic: IEnumOleDocumentViews::Clone Next Topic: IEnumOleDocumentViews::Reset

IEnumOleDocumentViews::Next

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

Enumerates the next cViews elements in the enumerator's list, returning them in rgpView, along with the actual number of enumerated elements in pcFetched. The enumerator object is responsible for calling IUnknown::AddRef and the caller is responsible for calling IUnknown::Release on each pointer returned in rgpView.

• Returns one of the following values:

  S_OK	The number of items requested in cViews is fetched.
  S_FALSE	Less than the number of items requested is fetched.
  OLE defined error code otherwise.

cViews

[in] Number of IOleDocumentView pointers to be written to the array pointed to by rgpView. If pcFetched is NULL, this argument must be 1.

rgpView

[out, max_is(cViews)] Address of an array of IOleDocumentView pointers that receive the enumerated interfaces. The caller is responsible for allocating this array, and the array must be able to contain at least the number of elements specified in cViews.

pcFetched

[out] Address of a ULONG variable that receives the actual number of views enumerated in the rgpView parameter. This argument can be NULL, in which case the cViews argument must be 1.

E_NOTIMPL is not allowed by this method as a return value. If an error value is returned, no entries in the rgpView array are valid and no calls to IUnknown::Release are required.

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.