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

Требования

См. также

ClfsCloseAndResetLogFile

ClfsCreateLogFile