共用方式為

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

傳回碼 Description
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
 下列其中一個條件成立：
  • 原則參數的版本成員不等於CLFS_MGMT_POLICY_VERSION。
  • Policy 參數的值等於 ClfsMgmtPolicyInvalid。
  • Policy 參數的 PolicyFlags 成員指定LOG_POLICY_OVERWRITE以外的任何旗標。
STATUS_LOG_POLICY_ALREADY_INSTALLED
 記錄檔已經有此類型的原則，而且未設定LOG_POLICY_OVERWRITE旗標。
STATUS_INSUFFICIENT_RESOURCES
 記憶體不足，無法完成作業。
 

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

備註

原則是變動性的。 當記錄檔的所有句柄都關閉時，原則將會遺失。 每次註冊第一個用戶端時，您應該安裝原則。

您應該只在建立記錄的第一個容器之前，先註冊 PolicyType 成員等於 ClfsMgmtPolicyNewContainerSize 的CLFS_MGMT_POLICY結構。 系統會忽略任何後續的註冊。

即使 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