共用方式為


ClfsMgmtInstallPolicy 函式 (wdm.h)

ClfsMgmtInstallPolicy 例程會將 CLFS_MGMT_POLICY 結構新增至實體記錄。

語法

CLFSUSER_API NTSTATUS ClfsMgmtInstallPolicy(
  [in] PLOG_FILE_OBJECT  LogFile,
  [in] PCLFS_MGMT_POLICY Policy,
  [in] ULONG             PolicyLength
);

參數

[in] LogFile

LOG_FILE_OBJECT 結構的指標,表示這個 CLFS_MGMT_POLICY 結構實例將套用至的 CLFS 記錄。 原則會套用至記錄檔內的所有數據流,即使已指定記錄檔內的單一數據流也一樣。

[in] Policy

包含要安裝之原則之 CLFS_MGMT_POLICY 結構的指標。

[in] PolicyLength

Policy 參數所指向之結構的長度,以位元組為單位。

傳回值

ClfsMgmtInstallPolicy 例程會傳回下列其中一個 NTSTATUS 值:

傳回碼 描述
STATUS_SUCCESS
原則已安裝。
STATUS_INVALID_PARAMETER_1
已為 logFile 參數提供 NULL 值。
STATUS_INVALID_PARAMETER_2
已為 Policy 參數提供 NULL 值。
STATUS_INVALID_PARAMETER_3
PolicyLength 參數的值小於 CLFS_MGMT_POLICY 結構的實例大小。
STATUS_NOT_SUPPORTED
Policy 參數所指向之 CLFS_MGMT_POLICY_STRUCTUREPolicyFlags 成員會指定LOG_POLICY_OVERWRITE以外的任何旗標。
STATUS_INVALID_PARAMETER
下列其中一個條件成立:
  • Policy 參數的 Version 成員不等於 CLFS_MGMT_POLICY_VERSION。
  • Policy 參數的值等於 ClfsMgmtPolicyInvalid
  • Policy 參數的 PolicyFlags 成員會指定LOG_POLICY_OVERWRITE以外的任何旗標。
STATUS_LOG_POLICY_ALREADY_INSTALLED
記錄檔已有此類型的原則,且未設定LOG_POLICY_OVERWRITE旗標。
STATUS_INSUFFICIENT_RESOURCES
記憶體不足,無法完成作業。
 

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

言論

原則是不穩定的。 當記錄檔的所有句柄都關閉時,原則將會遺失。 每次註冊第一個用戶端時,都應該安裝原則。

您應該只註冊 CLFS_MGMT_POLICY 結構,其 PolicyType 成員等於 ClfsMgmtPolicyNewContainerSize,再建立記錄中的第一個容器。 系統會忽略任何後續的註冊。

安裝的記錄原則會套用至實體記錄檔,即使 LogFile 參數指定記錄數據流也一樣。

要求

要求 價值
最低支援的用戶端 適用於 Windows Server 2003 R2、Windows Vista 和更新版本的 Windows。
目標平臺 桌面
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
連結庫 Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

另請參閱

CLFS_MGMT_POLICY