Функция 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

См. также раздел

ClfsCloseAndResetLogFile

ClfsCreateLogFile