Función EvtSetChannelConfigProperty (winevt.h)

Establece la propiedad de configuración especificada de un canal.

Sintaxis

BOOL EvtSetChannelConfigProperty(
  [in] EVT_HANDLE                     ChannelConfig,
  [in] EVT_CHANNEL_CONFIG_PROPERTY_ID PropertyId,
  [in] DWORD                          Flags,
  [in] PEVT_VARIANT                   PropertyValue
);

Parámetros

[in] ChannelConfig

Identificador de las propiedades de configuración del canal que devuelve la función EvtOpenChannelConfig .

[in] PropertyId

Identificador de la propiedad de canal que se va a establecer. Para obtener una lista de identificadores de propiedad, consulte la enumeración EVT_CHANNEL_CONFIG_PROPERTY_ID .

[in] Flags

Reservado. Debe ser cero.

[in] PropertyValue

Valor de la propiedad que se establecerá.

Búfer asignado por el autor de la llamada que contiene el nuevo valor de propiedad de configuración. El búfer contiene un objeto EVT_VARIANT . Asegúrese de establecer el valor de configuración y el tipo de variante.

Valor devuelto

Código o valor devuelto	Descripción
TRUE	La función se ha realizado correctamente.
FALSE	Error en la función. Para obtener el código de error, llame a la función GetLastError .

Comentarios

Esta función cambia una copia en memoria de las propiedades de configuración. Para aplicar los cambios realizados en una o varias de las propiedades de configuración, llame a la función EvtSaveChannelConfig .

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

EvtGetChannelConfigProperty

EvtOpenChannelConfig

EvtSaveChannelConfig