Функция ClfsSetEndOfLog (wdm.h)

Статья
08/08/2023

Подпрограмма ClfsSetEndOfLog усекает поток CLFS.

Синтаксис

CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PCLFS_LSN        plsnEnd
);

Параметры

[in] plfoLog

Указатель на структуру LOG_FILE_OBJECT , представляющую поток CLFS. Этот поток должен быть единственным потоком выделенного журнала. Вызывающий объект ранее получил этот указатель, вызвав ClfsCreateLogFile.

[in] plsnEnd

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

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

ClfsSetEndOfLog возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Номер LSN, указанный в значении plsnEnd , не проверяется. Вызывающий объект отвечает за предоставление допустимого номера LSN; то есть , который является точным номером LSN записи в потоке.

Этот поток, представленный plfoLog, должен быть из выделенного журнала. Эта подпрограмма не поддерживает потоки из мультиплексированных журналов.

Описание основных понятий и терминологии CLFS см. в разделе Common Log File System.

Подпрограмма режима ядра ClfsSetEndOfLog зарезервирована для использования в будущем и в настоящее время всегда возвращает STATUS_NOT_SUPPORTED. Однако в настоящее время поддерживается подпрограмма SetEndOfLog в пользовательском режиме.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа	Персональный компьютер
Верхняя часть	wdm.h (включая Wdm.h)
Библиотека	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL