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

Статья
11/20/2024

Открывает дескриптор журнала событий резервного копирования, созданного функцией BackupEventLog.

Синтаксис

HANDLE OpenBackupEventLogW(
  [in] LPCWSTR lpUNCServerName,
  [in] LPCWSTR lpFileName
);

Параметры

[in] lpUNCServerName

Имя универсального соглашения об именовании (UNC) удаленного сервера, на котором должна выполняться эта операция. Если этот параметр NULL, используется локальный компьютер.

[in] lpFileName

Полный путь к файлу резервной копии.

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

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

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

Замечания

Если имя файла резервной копии указывает удаленный сервер, параметр lpUNCServerName должен быть null.

Если эта функция используется на компьютерах Windows Vista и более поздних версий, можно открыть только журналы событий резервного копирования, сохраненные с помощью функции BackupEventLog в Windows Vista и более поздних компьютерах.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	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)

См. также

BackupEventLog

Функции ведения журнала событий

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