SetLogFileSizeWithPolicy 函式 (clfsmgmtw32.h)

根據已安裝原則的狀態，從記錄檔新增或刪除容器。

語法

CLFSUSER_API BOOL SetLogFileSizeWithPolicy(
  [in]  HANDLE     hLog,
  [in]  PULONGLONG pDesiredSize,
  [out] PULONGLONG pResultingSize
);

[in] hLog

記錄的控制碼。

[in] pDesiredSize

值的指標，指定要求的記錄檔大小，以下列其中一個值表示。如需實際的結果大小，請參閱 pResultingSize 參數。

值	意義
0	強制執行最小大小原則。如果未安裝最小大小原則，就會發生下列其中一項：如果記錄檔少於兩個容器，則記錄檔將會擴充為兩個容器的大小。如果記錄檔有兩個以上的容器，則不會進行任何變更，而且函式調用會成功。如果已安裝最小大小原則，就會發生下列其中一項：如果記錄檔的容器數目少於最小大小原則所指定的容器數目，則記錄會展開至原則指定的最小容器數目。如果記錄檔的容器數目大於或等於最小大小原則所指定的容器數目下限，則不會進行任何變更，而且函式調用不會成功，而且不會發生任何錯誤。如需詳細資訊，請參閱 InstallLogPolicy。
1	不是有效的值;函式呼叫失敗， ERROR_INVALID_PARAMETER。
2–1023	記錄檔所需的大小，以容器數目表示。如果此數目小於已安裝原則所指定的容器數目下限，則函式呼叫會失敗，並ERROR_COULD_NOT_RESIZE_LOG。如果此數目大於已安裝原則所指定的容器數目上限，則記錄檔只會擴充至原則指定的容器數目上限，而且函式會成功，且不會發生錯誤。
1024–MAXULONGLONG	如果未安裝大小上限原則，函式呼叫會失敗，並 ERROR_LOG_POLICY_CONFLICT。如果已安裝大小上限原則，則記錄檔會擴充至大小上限原則所指定的容器數目上限，而且函式不會發生錯誤。

[out] pResultingSize

有效 ULONGLONG 資料變數的指標，會在成功時接收調整大小記錄檔中的容器數目。

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError 函式。

容器是使用與 .blf 檔案相同的安全性屬性來建立，而且是在應用程式的內容中建立，而不是 .blf 檔案擁有者的內容。如需 .blf 檔案的詳細資訊，請參閱記錄類型。如果容器遭到刪除，則會使用呼叫應用程式的安全性內容來刪除這些容器。

如需使用此函式的範例，請參閱建立記錄檔。