다음을 통해 공유

IEnumShellItems::Next 메서드(shobjidl_core.h)

  • 아티클

열거형에서 하나 이상의 IShellItem 인터페이스 배열을 가져옵니다.

구문

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

매개 변수

[in] celt

형식: ULONG

rgelt 매개 변수에서 참조하는 배열의 요소 수입니다.

[out] rgelt

형식: IShellItem**

열거된 항목 또는 항목을 수신하는 IShellItem 인터페이스에 대한 포인터 배열의 주소입니다. 호출 애플리케이션은 IUnknown::Release 메서드를 호출하여 IShellItem 인터페이스를 해제합니다.

[out] pceltFetched

형식: ULONG*

성공적으로 검색된 IShellItem 인터페이스 수를 수신하는 값에 대한 포인터입니다. 개수는 celt 매개 변수에 지정된 값보다 작을 수 있습니다. 이 매개 변수는 celt가 1인 경우에만 항목에서 NULL일 수 있습니다. 이 경우 메서드는 하나의 항목만 검색하고 S_OK 반환하거나 0개의 항목만 반환하고 S_FALSE 반환할 수 있기 때문입니다.

반환 값

형식: HRESULT

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드 Description
S_OK
 IShellItem 인터페이스를 검색한 경우
S_FALSE
 열거형에 IShellItem 인터페이스가 더 이상 없으면 입니다.
다른 이유로 인해 함수가 실패하면 오류 값을 반환합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shobjidl.h 포함)

추가 정보

IEnumShellItems

IShellItem