Compartir a través de

Método IWiaItem::EnumRegisterEventInfo (wia_xp.h)

  • Artículo

El método IWiaItem::EnumRegisterEventInfo crea un enumerador que se usa para obtener información sobre los eventos para los que se registra una aplicación.

Sintaxis

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

Parámetros

[in] lFlags

Tipo: LONG

Actualmente no se usa. Debe establecerse como cero.

[in] pEventGUID

Tipo: GUID const*

Puntero a un identificador que especifica el evento de hardware para el que desea obtener información de registro.

[out] ppIEnum

Tipo: IEnumWIA_DEV_CAPS**

Recibe la dirección de un puntero a la interfaz IEnumWIA_DEV_CAPS .

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Una aplicación invoca este método para crear un objeto enumerador para la información del evento. IWiaItem::EnumRegisterEventInfo almacena la dirección de la interfaz IEnumWIA_DEV_CAPS del objeto enumerador en el parámetro ppIEnum . A continuación, el programa usa el puntero de interfaz para enumerar las propiedades del evento para el que está registrado.

Cada estructura de WIA_DEV_CAP incluye una indicación de si el evento es de tipo WIA_NOTIFICATION_EVENT o WIA_ACTION_EVENT o ambos.

Las aplicaciones deben llamar al método IUnknown::Release en los punteros de interfaz que reciben a través del parámetro ppIEnum .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wia_xp.h (incluye Wia.h)
Library Wiaguid.lib
Archivo DLL Wiaservc.dll