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

지정된 수의 IDLIST_ABSOLUTE 항목을 검색합니다.

구문

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

매개 변수

[in] celt

형식: ULONG

rgelt 매개 변수에서 참조하는 배열에서 참조되는 항목 수입니다.

[out] rgelt

형식: PIDLIST_ABSOLUTE*

성공하면 PIDL 배열이 포함됩니다. 구현은 CoTaskMemAlloc를 사용하여 이러한 항목 식별자를 할당해야 합니다. 호출 애플리케이션은 CoTaskMemFree를 사용하여 항목 식별자를 해제합니다.

[out] pceltFetched

형식: ULONG*

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

반환 값

형식: HRESULT

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

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

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

요구 사항

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