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

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.

Замечания

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

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

Требования

См. также

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING