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 메서드를 호출해야 합니다.

요구 사항