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

  • 아티클

열거형 시퀀스에서 지정된 수의 항목 식별자를 검색하고 검색된 항목 수만큼 현재 위치를 이동합니다.

구문

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

매개 변수

[in] celt

형식: ULONG

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

[out] rgelt

형식: LPITEMIDLIST*

항목 식별자를 수신하는 ITEMIDLIST 포인터 배열에 대한 포인터의 주소입니다. 구현은 CoTaskMemAlloc를 사용하여 이러한 항목 식별자를 할당해야 합니다. 호출 애플리케이션은 CoTaskMemFree를 사용하여 항목 식별자를 해제합니다.

배열에 반환된 ITEMIDLIST 구조체는 열거 중인 IShellFolder 를 기준으로 합니다.

[out] pceltFetched

형식: ULONG*

rgelt에서 실제로 반환된 항목 식별자 수를 수신하는 값에 대한 포인터입니다. 개수는 celt 매개 변수에 지정된 값보다 작을 수 있습니다. 이 매개 변수는 셀트 = 1인 경우에만 항목에서 NULL일 수 있습니다. 이 경우 메서드는 하나(S_OK) 또는 0(S_FALSE) 항목만 검색할 수 있기 때문입니다.

반환 값

형식: HRESULT

메서드가 요청된 celt 요소를 성공적으로 검색한 경우 S_OK 반환합니다. 이 메서드는 요청된 항목의 전체 개수를 성공적으로 검색한 경우에만 S_OK 반환합니다.

S_FALSE 열거형에 남아 있는 것보다 더 많은 항목이 요청되었음을 나타냅니다. pceltFetched 매개 변수가 가리키는 값은 검색된 실제 항목 수를 지정합니다. 검색할 항목이 더 이상 없으면 값이 0이 됩니다.

그렇지 않으면 COM 정의 오류 값을 반환합니다.

설명

이 메서드가 FAILED 매크로에 의해 결정된 대로 COM(구성 요소 개체 모델) 오류 코드를 반환하는 경우 rgelt 배열의 항목은 종료 시 유효하지 않습니다. 이 메서드가 성공 코드(예: S_OK 또는 S_FALSE)를 반환하는 경우 pceltFetched 매개 변수가 가리키는 ULONG은 종료할 때 유효한 rgelt 배열의 항목 수를 결정합니다.

셀트> 1의 경우 구분이 중요합니다. 예를 들어 celt=10을 전달하고 3개 요소만 남아 있는 경우 *pceltFetched 는 3이 되고 메서드는 파일 끝에 도달했음을 의미하는 S_FALSE 반환합니다. 페치된 세 개의 요소는 rgelt 에 저장되며 유효합니다.

요구 사항

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

추가 정보

IEnumIDList