共用方式為


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 所指定。 指定的路徑可以是絕對路徑,或相對於由 plfoLog 所表示之 CLFS 記錄檔的位置。 相對於基底記錄檔的路徑必須以 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

另請參閱

ClfsAddLogContainerSet

ClfsCreateLogFile

ClfsRemoveLogContainer

LOG_FILE_OBJECT

UNICODE_STRING