IEnumProgressItems::Next 메서드(imapi2fs.h)

열거형 시퀀스에서 지정된 수의 항목을 검색합니다.

구문

HRESULT Next(
  [in]  ULONG         celt,
  [out] IProgressItem **rgelt,
  [out] ULONG         *pceltFetched
);

매개 변수

[in] celt

검색할 항목 수입니다.

[out] rgelt

IProgressItem 인터페이스의 배열입니다. 완료되면 rgelt에서 각 인터페이스를 해제해야 합니다.

[out] pceltFetched

rgelt에서 반환된 요소 수입니다. celt가 하나인 경우 pceltFetchedNULL로 설정할 수 있습니다. 그렇지 않으면 이 메서드를 호출하기 전에 pceltFetched 값을 0으로 초기화합니다.

반환 값

요청된 요소 수(셀트)가 성공적으로 반환되거나 반환된 항목 수(pceltFetched)가 요청된 요소 수보다 작으면 S_OK 반환됩니다.

구현의 결과로 다른 성공 코드가 반환될 수 있습니다. 다음 오류 코드는 일반적으로 작업 실패 시 반환되지만 가능한 유일한 오류 값은 나타내지 않습니다.

반환 코드 설명
E_POINTER
포인터가 잘못되었습니다.

값: 0x80004003

E_OUTOFMEMORY
필요한 메모리를 할당하지 못했습니다.

값: 0x8007000E

E_INVALIDARG
하나 이상의 인수가 잘못되었습니다.

값: 0x80070057

설명

시퀀스에 남아 있는 요청된 요소 수보다 적은 수의 요소가 있으면 나머지 요소를 검색합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 imapi2fs.h

추가 정보

IEnumProgressItems

IEnumProgressItems::RemoteNext