Функция 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 (include Wdm.h) |
| библиотеки | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |