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