ClfsMgmtInstallPolicy-Funktion (wdm.h)

  • Artikel

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 instance der CLFS_MGMT_POLICY-Struktur angewendet wird. Die Richtlinie gilt für alle Datenströme innerhalb des Protokolls, auch wenn ein einzelner Datenstrom innerhalb des Protokolls 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 Bytes, auf die der Policy-Parameter 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 LogFile-Parameter wurde ein NULL-Wert angegeben.
STATUS_INVALID_PARAMETER_2
 Für den Policy-Parameter wurde ein NULL-Wert angegeben.
STATUS_INVALID_PARAMETER_3
 Der Wert des PolicyLength-Parameters ist kleiner als die Größe eines instance der CLFS_MGMT_POLICY-Struktur.
STATUS_NOT_SUPPORTED
 Das PolicyFlags-Element der CLFS_MGMT_POLICY_STRUCTURE , auf die der Policy-Parameter verweist, gibt jedes andere Flag als LOG_POLICY_OVERWRITE an.
STATUS_INVALID_PARAMETER
 Eine der folgenden Bedingungen ist erfüllt:
  • Das Version-Element des Policy-Parameters ist nicht gleich CLFS_MGMT_POLICY_VERSION.
  • Der Wert des Policy-Parameters ist gleich ClfsMgmtPolicyInvalid.
  • Der PolicyFlags-Member des Policy-Parameters 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 flag LOG_POLICY_OVERWRITE ist nicht festgelegt.
STATUS_INSUFFICIENT_RESOURCES
 Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang abzuschließen.
 

Diese Routine gibt möglicherweise auch andere NTSTATUS-Werte zurück.

Hinweise

Richtlinien sind flüchtig. Wenn alle Handles für das Protokoll geschlossen werden, gehen die Richtlinien verloren. Sie sollten Richtlinien bei jeder Registrierung des ersten Clients installieren.

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 auch dann für das physische Protokoll, wenn der LogFile-Parameter einen Protokolldatenstrom angibt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform Desktop
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Weitere Informationen

CLFS_MGMT_POLICY