ClfsAddLogContainer 函式 (wdm.h)
ClfsAddLogContainer 例程會將容器新增至 CLFS 記錄。
語法
CLFSUSER_API NTSTATUS ClfsAddLogContainer(
[in] PLOG_FILE_OBJECT plfoLog,
[in] PULONGLONG pcbContainer,
[in] PUNICODE_STRING puszContainerPath
);
參數
[in] plfoLog
LOG_FILE_OBJECT 結構的指標，表示容器將加入的記錄檔。 呼叫端先前藉由呼叫 ClfsCreateLogFile 來取得此指標。
[in] pcbContainer
ULONG 型別變數的指標。 此參數的角色取決於記錄檔目前是否至少有一個容器。
- 如果記錄檔目前沒有容器，則呼叫端會提供正整數，表示新容器的要求大小，以位元組為單位。 CLFS 會針對專用記錄) 或多任務記錄) 建立要求的大小四捨五入為 512KB (的倍數或 1MB (。
- 如果記錄檔目前至少有一個容器，且此參數為 NULL 指標，CLFS 會建立與現有容器大小相同的新容器。 (記錄中的所有容器都必須是相同的大小。)
- 如果記錄檔目前至少有一個容器，且此參數是有效的指標，則呼叫端會提供正整數，該整數是新容器的要求大小，以位元組為單位。 要求的大小會四捨五入為專用記錄) 的 512KB (，或多任務記錄) 的 1MB (。 如果進位大小至少與現有容器大小相同，CLFS 會建立與現有容器大小相同的新容器。 成功傳回時，此參數會接收現有的容器大小。 如果進位大小小於現有的容器大小， ClfsAddLogContainer 就會失敗。
[in] puszContainerPath
提供新容器路徑名稱 之UNICODE_STRING 結構的指標。 路徑可以是絕對或相對於基底記錄檔的位置。 相對於基底記錄檔的路徑必須以CLFS_CONTAINER_RELATIVE_PREFIX開頭，也就是字串常值 (L“%BLF%\”) 。
傳回值
ClfsAddLogContainer 如果成功，則會傳回STATUS_SUCCESS;否則，它會傳回 Ntstatus.h 中定義的其中一個錯誤碼。
備註
容器是穩定記憶體的連續範圍。 例如，容器可能是磁碟上的連續檔案。 記錄檔是一組容器以及基底記錄檔。 如需容器的詳細資訊，請參閱 CLFS 穩定記憶體。
由相對於基底記錄檔的路徑所指定的容器，必須與基底記錄檔或基底記錄檔的子目錄位於相同的目錄中。 相對路徑中不允許目錄 「.」 和 「.」。
記錄檔可以有一些具有絕對路徑的容器，以及其他具有相對路徑的容器。
容器是以非壓縮模式建立，並以零初始化。
記錄檔必須至少有兩個容器，才能對它執行任何 I/O。
如需CLFS概念和術語的說明，請參閱 一般記錄檔系統。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 可在 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows 中使用。 |
| 目標平台 | 桌面 |
| 標頭 | wdm.h (包含 Wdm.h) |
| 程式庫 | Clfs.lib |
| Dll | Clfs.sys |
| IRQL | <= APC_LEVEL |