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