Функция 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 (include Wdm.h) |
| библиотеки | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |