ClfsMgmtInstallPolicy-Funktion (wdm.h)

Artikel
02/07/2025

Die ClfsMgmtInstallPolicy Routine fügt einem physischen Protokoll eine CLFS_MGMT_POLICY Struktur hinzu.

Syntax

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

Parameter

[in] LogFile

Ein Zeiger auf eine LOG_FILE_OBJECT-Struktur, die das CLFS-Protokoll darstellt, auf das diese Instanz der CLFS_MGMT_POLICY-Struktur angewendet wird. Die Richtlinie gilt für alle Datenströme im Protokoll, auch wenn ein einzelner Datenstrom im Protokoll angegeben wurde.

[in] Policy

Ein Zeiger auf eine CLFS_MGMT_POLICY Struktur, die die zu installierende Richtlinie enthält.

[in] PolicyLength

Die Länge der Struktur in Byte, auf die der parameter Policy verweist.

Rückgabewert

Die ClfsMgmtInstallPolicy Routine gibt einen der folgenden NTSTATUS-Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Richtlinie wurde installiert.
STATUS_INVALID_PARAMETER_1	Für den parameter LogFile wurde ein NULL- Wert angegeben.
STATUS_INVALID_PARAMETER_2	Ein NULL--Wert wurde für den parameter Policy angegeben.
STATUS_INVALID_PARAMETER_3	Der Wert des PolicyLength--Parameters ist kleiner als die Größe einer Instanz der CLFS_MGMT_POLICY-Struktur.
STATUS_NOT_SUPPORTED	Das PolicyFlags Mitglied der CLFS_MGMT_POLICY_STRUCTURE, auf das der parameter Policy verweist, gibt ein anderes Kennzeichen als LOG_POLICY_OVERWRITE an.
STATUS_INVALID_PARAMETER	Eine der folgenden Bedingungen gilt: Das Element Richtlinie Parameters Version Ist nicht gleich CLFS_MGMT_POLICY_VERSION. Der Wert des Policy -Parameters ist gleich ClfsMgmtPolicyInvalid. Das Policyflags-Element des Parameters PolicyFlags Element gibt ein anderes Flag als LOG_POLICY_OVERWRITE an.
STATUS_LOG_POLICY_ALREADY_INSTALLED	Das Protokoll verfügt bereits über eine Richtlinie dieses Typs, und das LOG_POLICY_OVERWRITE Flag ist nicht festgelegt.
STATUS_INSUFFICIENT_RESOURCES	Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.

Diese Routine kann auch andere NTSTATUS-Wertezurückgeben.

Bemerkungen

Richtlinien sind veränderlich. Wenn alle Handles für das Protokoll geschlossen werden, gehen die Richtlinien verloren. Sie sollten Richtlinien jedes Mal installieren, wenn Sie den ersten Client registrieren.

Sie sollten nur eine CLFS_MGMT_POLICY Struktur registrieren, deren PolicyType Member gleich ClfsMgmtPolicyNewContainerSize ist, bevor der erste Container im Protokoll erstellt wird. Alle nachfolgenden Registrierungen werden ignoriert.

Die installierte Protokollrichtlinie gilt für das physische Protokoll, auch wenn der LogFile Parameter einen Protokolldatenstrom angibt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform-	Desktop
Header-	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library	Clfs.lib
DLL-	Clfs.sys
IRQL-	<= APC_LEVEL

Siehe auch

CLFS_MGMT_POLICY

Freigeben über