Функция ClfsSetEndOfLog (wdm.h)
Подпрограмма 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 |