Функция SetLogArchiveTail (clfsw32.h)

  • Статья

Задает последний порядковый номер архивированного журнала (LSN) или архивный хвост архивного журнала.

Синтаксис

CLFSUSER_API BOOL SetLogArchiveTail(
  [in]                HANDLE    hLog,
  [in]                PCLFS_LSN plsnArchiveTail,
  [in, out, optional] LPVOID    pReserved
);

Параметры

[in] hLog

Дескриптор журнала, полученного из CreateLogFile.

Дескриптор журнала может ссылаться на выделенный или мультиплексный журнал.

[in] plsnArchiveTail

Указатель на структуру CLFS_LSN , указывающую допустимый физический номер LSN в журнале.

Примечание Для дескрипторов как для физического журнала, так и для потока журнала , plsnArchiveTail является физическим номером LSN, так как он ссылается на адрес записи в физическом журнале.
 

[in, out, optional] pReserved

Этот параметр зарезервирован и должен иметь значение NULL.

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

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

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

В следующем списке указаны возможные коды ошибок:

Комментарии

Если есть архивные контексты, полученные из PrepareLogArchive , которые не завершаются с помощью TerminateLogArchive, изменение не вступит в силу до тех пор, пока не будут завершены все архивы. Хотя существуют невыполненные контексты архива, применяется только наибольший хвост архива.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 R2 [только классические приложения]
Целевая платформа Windows
Header clfsw32.h
Библиотека Clfsw32.lib
DLL Clfsw32.dll

См. также раздел

CLFS_LSN

Общие функции файловой системы журнала

ПЕРЕКРЫВАЮЩИХСЯ

RemoveLogContainer

RemoveLogContainerSet