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