Prev Next

BackupEventLog info  Overview  Group

The BackupEventLog function saves the specified event log to a backup file. The function does not clear the event log.

BOOL BackupEventLog(

    HANDLE hEventLog,

// handle to event log

    LPCTSTR lpBackupFileName 

// name of backup file

   );

Parameters

hEventLog
Identifies the open event log. This handle is returned by the OpenEventLog or OpenBackupEventLog function.
lpBackupFileName
Pointer to a null-terminated string that names the backup file. The backup filename may contain a server name to save the backup file on a remote server.

Return Values

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

If the backup filename specifies a remote server, the event log handle must identify a log on the local computer. You cannot back up an event logfile from a remote server to a file on a remote server (even if the backup file and the original log are on the same server).

See Also

OpenBackupEventLog, OpenEventLog