Функция ClfsCloseAndResetLogFile (wdm.h)
Программа ClfsCloseAndResetLogFile освобождает все ссылки на указанный объект файла журнала и помечает связанный поток для сброса.
CLFSUSER_API NTSTATUS ClfsCloseAndResetLogFile(
[in] PLOG_FILE_OBJECT plfoLog
);
[in] plfoLog
Указатель на структуру LOG_FILE_OBJECT, для которой будут выпущены ссылки. Вызывающий объект ранее получил этот указатель путем вызова ClfsCreateLogFile.
ClfsCloseAndResetLogFile возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в Ntstatus.h.
ClfsCloseAndResetLogFile освобождает все ссылки, приобретенные CLFS, в указанный объект файла журнала. Как правило, клиент не получит никаких дополнительных ссылок на объект файла журнала. Однако если клиент получил дополнительные ссылки, это ответственность клиента за их освобождение.
ClfsCloseAndResetLogFile приводит к удалению указанного объекта файла журнала до нуля, в то время как объект файла журнала закрыт (то есть его память освобождена). Однако поток, представленный объектом файла журнала, не может быть сброшен, так как могут быть другие объекты файлов журнала, представляющие тот же поток. Поток сбрасывается после закрытия всех объектов файлов журнала, представляющих поток (например, вызовами ClfsCloseLogFileObject).
Поток сброса похож на только что созданный поток, который никогда не записывал в него записи.
При возврате из этой процедуры plfoLog недопустимо.
Вы можете вызывать ClfsCloseAndResetLogFile не более 124 раз для заданного потока.
Описание концепций и терминологии CLFS см. в common Log File System.
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows. |
| целевая платформа | Настольный |
| заголовка | wdm.h (include Wdm.h) |
| библиотеки | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |