共用方式為

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 值。

傳回碼 描述
STATUS_SUCCESS
 已設定記錄檔大小。
STATUS_INVALID_PARAMETER_1
 LogFile 參數的值 NULL，或 NewSizeInContainers 參數的內容為 1。
STATUS_INVALID_PARAMETER_2
 NewSizeInContainers 參數的值 NULL。
STATUS_LOG_POLICY_INVALID
 記錄檔上已安裝的原則集無效。 這可能是因為 clfsMgmtPolicyAutoShrink 原則或 ClfsMgmtPolicyMaximumSize 原則而無效。
STATUS_COULD_NOT_RESIZE_LOG
 CLFS 管理無法刪除足夠的容器，無法達到 newSizeInContainers 中的值。
STATUS_LOG_POLICY_CONFLICT
 指定記錄檔上的原則導致作業無法完成。 如果 CLFS 管理無法將足夠的容器新增至記錄檔，以達到 NewSizeInContainers中的值，就可能發生此情況。 這可能是因為與客戶端設定的原則發生衝突。
 

此例程也可能 傳回其他NTSTATUS 值。

要求

要求 價值
最低支援的用戶端 適用於 Windows 7 和更新版本的 Windows。
目標平臺 桌面
標頭 wdm.h
DLL Clfs.sys

另請參閱

CLFS 管理連結庫例程