Leer en inglés

Compartir a través de


Función EvtClearLog (winevt.h)

Quita todos los eventos del canal especificado y los escribe en el archivo de registro de destino.

Sintaxis

BOOL EvtClearLog(
  [in, optional] EVT_HANDLE Session,
  [in]           LPCWSTR    ChannelPath,
  [in, optional] LPCWSTR    TargetFilePath,
  [in]           DWORD      Flags
);

Parámetros

[in, optional] Session

Identificador de sesión remota que devuelve la función EvtOpenSession . Establezca en NULL para los canales locales.

[in] ChannelPath

Nombre del canal que se va a borrar.

[in, optional] TargetFilePath

Ruta de acceso completa al archivo de registro de destino que recibirá los eventos. Establezca en NULL para borrar el archivo de registro y no guardar los eventos.

[in] Flags

Reservado. Debe ser cero.

Valor devuelto

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

Comentarios

Para copiar eventos desde un canal o archivo de registro, llame a la función EvtExportLog .

Debe especificar la ruta de acceso absoluta al archivo de registro de destino; No puede usar rutas de acceso relativas y variables de entorno para especificar el archivo de registro de destino. La ruta de acceso puede ser una ruta de acceso de convención de nomenclatura universal (UNC). Debe usar .evtx como extensión de nombre de archivo.

Esta función afecta solo al canal; si el canal usa autoBackup o fileMax, esta función no afectará a esos archivos de copia de seguridad.

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

EvtArchiveExportedLog

EvtExportLog