Función EvtOpenChannelEnum (winevt.h)

Obtiene un identificador que se usa para enumerar la lista de canales registrados en el equipo.

Sintaxis

EVT_HANDLE EvtOpenChannelEnum(
  [in] EVT_HANDLE Session,
  [in] DWORD      Flags
);

Parámetros

[in] Session

Identificador de sesión remota que devuelve la función EvtOpenSession . Establezca en NULL para enumerar los canales del equipo local.

[in] Flags

Reservado. Debe ser cero.

Valor devuelto

Si se ejecuta correctamente, la función devuelve un identificador a la lista de nombres de canal registrados en el equipo; de lo contrario, NULL. Si es NULL, llame a la función GetLastError para obtener el código de error.

Comentarios

La enumeración incluye todos los canales que los proveedores que están registrados en el equipo definido. Para enumerar los nombres de canal, llame a la función EvtNextChannelPath en un bucle. Los nombres se ordenan alfabéticamente.

Debe llamar a la función EvtClose para cerrar el identificador del enumerador cuando haya terminado.

Ejemplos

Para obtener un ejemplo que muestra cómo usar esta función, vea Obtener y establecer las propiedades de configuración de un canal.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winevt.h
Library	Wevtapi.lib
Archivo DLL	Wevtapi.dll

Consulte también

EvtNextChannelPath

EvtOpenChannelConfig