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 |
---|---|
|
IShellItem 인터페이스를 검색한 경우 |
|
열거형에 IShellItem 인터페이스가 더 이상 없으면 입니다. |
다른 이유로 인해 함수가 실패하면 오류 값을 반환합니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | shobjidl_core.h(Shobjidl.h 포함) |