IEnumWiaItem2::Next 메서드
IWiaItem2 인터페이스에 대한 포인터 배열을 채웁니다.
구문
HRESULT Next(
[in] ULONG cElt,
[out] IWiaItem2 **ppIWiaItem2,
[in, out] ULONG *pcEltFetched
);
매개 변수
-
cElt [in]
-
형식: ULONG
ppIWiaItem2 매개 변수로 표시된 배열의 배열 요소 수를 지정합니다.
-
ppIWiaItem2 [out]
-
형식: IWiaItem2**
IWiaItem2 인터페이스 포인터 배열의 주소를 받습니다. IEnumWiaItem2::Next 는 이 배열을 인터페이스 포인터로 채웁니다.
-
pcEltFetched [in, out]
-
형식: ULONG*
출력 시 이 매개 변수는 ppIWiaItem2 매개 변수로 표시된 배열에 실제로 저장된 인터페이스 포인터 수를 받습니다. 열거형이 완료되면 이 매개 변수에 0이 포함됩니다.
반환 값
형식: HRESULT
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
WIA(Windows 이미지 획득) 2.0 런타임 시스템은 WIA 2.0 하드웨어 디바이스를 IWiaItem2 개체의 계층 트리로 나타냅니다. 애플리케이션은 IEnumWiaItem2::Next 메서드를 사용하여 하드웨어 디바이스 의 IWiaItem2 개체 트리의 현재 폴더에 있는 각 항목에 대한 IWiaItem2 인터페이스 포인터를 가져옵니다.
포인터 목록을 가져오기 위해 애플리케이션은 할당하는 IWiaItem2 인터페이스 포인터 배열을 전달합니다. 또한 cElt 매개 변수의 배열 요소 수를 전달합니다. IEnumWiaItem2::Next 메서드는 배열을 IWiaItem2 인터페이스에 대한 포인터로 채웁니다.
열거 프로세스가 완료될 때까지 IEnumWiaItem2::Next 메서드는 S_OK 반환합니다. 이 작업을 할 때마다 pcEltFetched 가 가리키는 값을 배열에 삽입한 항목 수로 설정합니다. IEnumWiaItem2::Next가 IWiaItem2 개체를 열거하는 프로세스를 완료하면 S_FALSE 반환하고 pcEltFetched가 가리키는 메모리 위치를 0으로 설정합니다.
애플리케이션은 ppIWiaItem2 매개 변수를 통해 수신하는 인터페이스 포인터에서 IUnknown::Release 메서드를 호출해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 |
|
| IDL |
|