Platform SDK: Debugging and Error Handling |
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 );
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.
The backup file cannot be written to a remote server because this function is implemented by a service running in the LocalSystem account, which does not have credentials on the remote machine. However, it is possible to write the file to a remote machine using a null session.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Unsupported.
Header: Declared in Winbase.h; include Windows.h.
Library: Use Advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.
Event Logging Overview, Event Logging Functions, OpenBackupEventLog, OpenEventLog