IEnumWiaItem::Next 메서드(wia_xp.h)

IEnumWiaItem::Next 메서드는 IWiaItem 인터페이스에 대한 포인터 배열을 채웁니다.

구문

HRESULT Next(
  [in]      ULONG    celt,
  [out]     IWiaItem **ppIWiaItem,
  [in, out] ULONG    *pceltFetched
);

매개 변수

[in] celt

형식: ULONG

ppIWiaItem 매개 변수로 표시된 배열의 배열 요소 수를 지정합니다.

[out] ppIWiaItem

형식: IWiaItem**

IWiaItem 인터페이스 포인터 배열의 주소를 받습니다. IEnumWiaItem::Next 는 이 배열을 인터페이스 포인터로 채웁니다.

[in, out] pceltFetched

형식: ULONG*

출력 시 이 매개 변수는 ppIWiaItem 매개 변수로 표시된 배열에 실제로 저장된 인터페이스 포인터 수를 받습니다. 열거형이 완료되면 이 매개 변수에는 0이 포함됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 메서드는 S_OK 반환합니다. 열거형이 완료되면 S_FALSE 반환합니다. 메서드가 실패하면 표준 COM 오류 코드를 반환합니다.

설명

WIA(Windows 이미지 획득) 런타임 시스템은 WIA 하드웨어 디바이스를 IWiaItem 개체의 계층 트리로 나타냅니다. 애플리케이션은 IEnumWiaItem::Next 메서드를 사용하여 하드웨어 디바이스 의 IWiaItem 개체 트리의 현재 폴더에 있는 각 항목에 대한 IWiaItem 인터페이스 포인터를 가져옵니다.

포인터 목록을 가져오기 위해 애플리케이션은 할당하는 IWiaItem 인터페이스 포인터 배열을 전달합니다. 또한 celt 매개 변수의 배열 요소 수를 전달합니다. IEnumWiaItem::Next 메서드는 배열을 IWiaItem 인터페이스에 대한 포인터로 채웁니다.

열거 프로세스가 완료될 때까지 IEnumWiaItem::Next 메서드는 S_OK 반환합니다. 이 작업을 할 때마다 pceltFetched 가 가리키는 값을 배열에 삽입한 항목 수로 설정합니다. IEnumWiaItem::Next가 IWiaItem 개체를 열거하는 프로세스를 완료하면 S_FALSE 반환하고 pceltFetched가 가리키는 메모리 위치를 0으로 설정합니다.

애플리케이션은 ppIWiaItem 매개 변수를 통해 수신하는 인터페이스 포인터에서 IUnknown::Release 메서드를 호출해야 합니다.

요구 사항