Функция ClfsRemoveLogContainer (wdm.h)

Подпрограмма ClfsRemoveLogContainer удаляет контейнер из журнала CLFS.

Синтаксис

CLFSUSER_API NTSTATUS ClfsRemoveLogContainer(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PUNICODE_STRING  puszContainerPath,
  [in] BOOLEAN          fForce
);

Параметры

[in] plfoLog

Указатель на структуру LOG_FILE_OBJECT , представляющую журнал CLFS, из которого будет удален контейнер. Вызывающий объект ранее получил этот указатель, вызвав ClfsCreateLogFile.

[in] puszContainerPath

Указатель на структуру UNICODE_STRING , которая предоставляет имя пути для удаляемого контейнера. Имя пути было создано при предыдущем вызове ClfsAddLogContainer или ClfsAddLogContainerSet. Путь может быть абсолютным или относительным к расположению базового файла журнала ДЛЯ журнала CLFS, представленного plfoLog. Пути относительно базового файла журнала должны начинаться с CLFS_CONTAINER_RELATIVE_PREFIX, который является строковым литералом (L"%BLF%\"). Каталоги "." и ".." не допускаются в относительном пути.

[in] fForce

Логическое значение, указывающее, является ли удаление контейнера принудительным (TRUE) или отложенным (FALSE).

Возвращаемое значение

ClfsRemoveLogContainer возвращает STATUS_SUCCESS в случае успешного выполнения; в противном случае возвращается один из кодов ошибок, определенных в ntstatus.h.

Комментарии

Принудительное удаление контейнера (fForce = TRUE) выполняется успешно, только если удаляемая контейнер не является частью активного журнала.

Описание концепций и терминологии CLFS см. в разделе Common Log File System.

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Server 2003 R2, Windows Vista и более поздних версиях Windows.
Целевая платформа Персональный компьютер
Верхняя часть wdm.h (включая Wdm.h)
Библиотека Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

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

ClfsAddLogContainer

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainerSet

LOG_FILE_OBJECT

UNICODE_STRING