The OpenBackupEventLog function opens a handle to a backup event log. This handle can be used with the BackupEventLog function.
HANDLE OpenBackupEventLog(
LPCTSTR lpUNCServerName, // backup file server name
LPCTSTR lpFileName // backup filename
);
If the function succeeds, the return value is a handle to the backup event log.
If the function fails, the return value is NULL. 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.
If the backup filename specifies a remote server, lpUNCServerName must be NULL.
Windows NT: Requires version 3.1 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in winbase.h.
Import Library: Use advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
Event Logging Overview, Event Logging Functions, BackupEventLog