Поделиться через


Функция BackupEventLogA (winbase.h)

Сохраняет указанный журнал событий в файл резервной копии. Функция не очищает журнал событий.

Синтаксис

BOOL BackupEventLogA(
  [in] HANDLE hEventLog,
  [in] LPCSTR lpBackupFileName
);

Параметры

[in] hEventLog

Дескриптор открытого журнала событий. Функция OpenEventLog возвращает этот дескриптор.

[in] lpBackupFileName

Абсолютный или относительный путь к файлу резервной копии.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение ненулевое.

Если функция завершается ошибкой, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

Функция BackupEventLog завершается ошибкой ERROR_PRIVILEGE_NOT_HELD, если у пользователя нет прав SE_BACKUP_NAME.

Заметка

Заголовок winbase.h определяет BackupEventLog как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка winbase.h (включая Windows.h)
библиотеки Advapi32.lib
DLL Advapi32.dll
набор API ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (представлено в Windows 10 версии 10.0.10240)

См. также

OpenBackupEventLog

OpenEventLog