Метод 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 . После завершения перечисления этот параметр содержит ноль.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Система времени выполнения windows Image Acquisition (WIA) 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 , равным нулю.
Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают с помощью параметра ppIWiaItem2 .
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista [только классические приложения] |
Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
Заголовок |
|
IDL |
|