ClfsMgmtSetLogFileSizeAsClient 函式 (wdm.h)
ClfsMgmtSetLogFileSizeAsClient 例程會將容器新增至用戶端記錄檔或刪除用戶端記錄檔,以設定記錄檔大小。
語法
CLFSUSER_API NTSTATUS ClfsMgmtSetLogFileSizeAsClient(
[in] PLOG_FILE_OBJECT LogFile,
[in, optional] CLFS_MGMT_CLIENT ClientCookie,
[in] PULONGLONG NewSizeInContainers,
[out, optional] PULONGLONG ResultingSizeInContainers,
[in, optional] PCLFS_SET_LOG_SIZE_COMPLETE_CALLBACK CompletionRoutine,
[in, optional] PVOID CompletionRoutineData
);
參數
[in] LogFile
LOG_FILE_OBJECT 結構的指標,代表要加入或刪除容器的一般記錄檔系統 (CLFS) 記錄檔或記錄檔內的數據流。 此參數的值是透過呼叫 clfsCreateLogFile 例程來取得。
[in, optional] ClientCookie
用戶端提供的 Cookie 指標。 此參數的值應該是透過呼叫 clfsMgmtRegisterManagedClient 例程取得的CLFS_MGMT_CLIENT 結構。
[in] NewSizeInContainers
記錄檔的所需大小,以容器數目表示。 記錄檔最多可以有1,024個容器。
[out, optional] ResultingSizeInContainers
記錄的實際大小,以容器數目表示。
[in, optional] CompletionRoutine
未使用。
[in, optional] CompletionRoutineData
未使用。
傳回值
ClfsMgmtSetLogFileSizeAsClient 例程會傳回 NTSTATUS 值。
傳回碼 | 描述 |
---|---|
|
已設定記錄檔大小。 |
|
LogFile 參數的值 NULL,或 NewSizeInContainers 參數的內容為 1。 |
|
NewSizeInContainers 參數的值 NULL。 |
|
記錄檔上已安裝的原則集無效。 這可能是因為 clfsMgmtPolicyAutoShrink 原則或 ClfsMgmtPolicyMaximumSize 原則而無效。 |
|
CLFS 管理無法刪除足夠的容器,無法達到 newSizeInContainers 中的值。 |
|
指定記錄檔上的原則導致作業無法完成。 如果 CLFS 管理無法將足夠的容器新增至記錄檔,以達到 NewSizeInContainers中的值,就可能發生此情況。 這可能是因為與客戶端設定的原則發生衝突。 |
此例程也可能 傳回其他NTSTATUS 值。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | 適用於 Windows 7 和更新版本的 Windows。 |
目標平臺 | 桌面 |
標頭 | wdm.h |
DLL | Clfs.sys |