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概念和術語的說明，請參閱 一般記錄檔系統。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌面 |
| 標頭 | wdm.h (包含 Wdm.h) |
| 程式庫 | Clfs.lib |
| Dll | Clfs.sys |
| IRQL | <= APC_LEVEL |