共用方式為

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

傳回碼 Description
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 管理連結庫例程