Поделиться через

Метод 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 . После завершения перечисления этот параметр будет содержать ноль.

Возвращаемое значение

Тип: HRESULT

Если метод завершается успешно, метод возвращает S_OK. После завершения перечисления возвращается S_FALSE. Если метод завершается сбоем, он возвращает стандартный код ошибки COM.

Комментарии

Система времени выполнения windows Image Acquisition (WIA) представляет аппаратные устройства WIA в виде иерархического дерева объектов IWiaItem . Приложения используют метод IEnumWiaItem::Next для получения указателя интерфейса IWiaItem для каждого элемента в текущей папке дерева объектов IWiaItem аппаратного устройства.

Чтобы получить список указателей, приложение передает массив указателей интерфейса IWiaItem , которые оно выделяет. Он также передает количество элементов массива в параметре celt . Метод IEnumWiaItem::Next заполняет массив указателями на интерфейсы IWiaItem .

До завершения процесса перечисления метод IEnumWiaItem::Next возвращает S_OK. Каждый раз, когда он это делает, он задает значение, на которое указывает pceltFetched , количество элементов, вставленных в массив. Когда IEnumWiaItem::Next завершает процесс перечисления объектов IWiaItem , он возвращает S_FALSE и устанавливает расположение памяти, на которое указывает pceltFetched , равным нулю.

Приложения должны вызывать метод IUnknown::Release для указателей интерфейса, которые они получают через параметр ppIWiaItem .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header wia_xp.h (включая Wia.h)
Библиотека Wiaguid.lib