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