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