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

Статья
08/08/2023

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

Синтаксис

CLFSUSER_API NTSTATUS ClfsRemoveLogContainerSet(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] USHORT           cContainers,
  [in] PUNICODE_STRING  rgwszContainerPath,
  [in] BOOLEAN          fForce
);

Параметры

[in] plfoLog

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

[in] cContainers

Количество контейнеров в наборе. Это количество элементов в массиве rgwszContainerPath .

[in] rgwszContainerPath

Указатель на массив UNICODE_STRING структур, каждая из которых предоставляет имя пути для одного из удаляемых контейнеров. Количество элементов в массиве задается cContainers. Заданный путь может быть абсолютным или относительным к расположению базового файла журнала CLFS, представленного plfoLog. Пути относительно базового файла журнала должны начинаться с CLFS_CONTAINER_RELATIVE_PREFIX, который является строковым литералом (L"%BLF%\"). Каталоги "." и ".." не допускаются в относительном пути.

[in] fForce

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

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

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

Требования

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

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

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING