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 值:
傳回碼 | 描述 |
---|---|
|
原則已安裝。 |
|
已為 logFile 參數提供 NULL 值。 |
|
已為 Policy 參數提供 NULL 值。 |
|
PolicyLength 參數的值小於 CLFS_MGMT_POLICY 結構的實例大小。 |
|
Policy 參數所指向之 CLFS_MGMT_POLICY_STRUCTUREPolicyFlags 成員會指定LOG_POLICY_OVERWRITE以外的任何旗標。 |
|
下列其中一個條件成立:
|
|
記錄檔已有此類型的原則,且未設定LOG_POLICY_OVERWRITE旗標。 |
|
記憶體不足,無法完成作業。 |
此例程也可能傳回其他 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 |