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

Метод IWiaItem::EnumRegisterEventInfo (wia_xp.h)

  • Статья

Метод IWiaItem::EnumRegisterEventInfo создает перечислитель, используемый для получения сведений о событиях, для которых зарегистрировано приложение.

Синтаксис

HRESULT EnumRegisterEventInfo(
  [in]  LONG              lFlags,
  [in]  const GUID        *pEventGUID,
  [out] IEnumWIA_DEV_CAPS **ppIEnum
);

Параметры

[in] lFlags

Тип: LONG

В настоящее время неиспользуется. Значение должно быть равно нулю.

[in] pEventGUID

Тип: const GUID*

Указатель на идентификатор, указывающий событие оборудования, для которого требуется информация о регистрации.

[out] ppIEnum

Тип: IEnumWIA_DEV_CAPS**

Получает адрес указателя на интерфейс IEnumWIA_DEV_CAPS .

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Приложение вызывает этот метод для создания объекта перечислителя для сведений о событии. IWiaItem::EnumRegisterEventInfo сохраняет адрес интерфейса IEnumWIA_DEV_CAPS объекта перечислителя в параметре ppIEnum . Затем программа использует указатель интерфейса для перечисления свойств события, для которого оно зарегистрировано.

Каждая WIA_DEV_CAP структура включает в себя указание типа события WIA_NOTIFICATION_EVENT, WIA_ACTION_EVENT или и того, и другое.

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

Требования

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