Función EvtOpenChannelConfig (winevt.h)

Artículo
08/27/2023

Obtiene un identificador que se usa para leer o modificar la propiedad de configuración de un canal.

Sintaxis

EVT_HANDLE EvtOpenChannelConfig(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    ChannelPath,
  [in] DWORD      Flags
);

Parámetros

[in] Session

Identificador de sesión remota que devuelve la función EvtOpenSession . Establezca en NULL para acceder a un canal en el equipo local.

[in] ChannelPath

Nombre del canal al que se va a acceder.

[in] Flags

Reservado. Debe ser cero.

Valor devuelto

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

Comentarios

Para obtener una propiedad de configuración, llame a la función EvtGetChannelConfigProperty .

Para modificar una propiedad de configuración, llame a la función EvtSetChannelConfigProperty . Para guardar los cambios de configuración, llame a la función EvtSaveChannelConfig .

Para enumerar los canales registrados, llame a la función EvtOpenChannelEnum .

Debe llamar a la función EvtClose para cerrar el identificador 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


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