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記錄檔的位置,而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 |