CLFS_MGMT_POLICY-Struktur (wdm.h)
Die CLFS_MGMT_POLICY-Struktur enthält eine Beschreibung einer Richtlinie zum Verwalten eines CLFS-Protokolls.
Syntax
typedef struct _CLFS_MGMT_POLICY {
ULONG Version;
ULONG LengthInBytes;
ULONG PolicyFlags;
CLFS_MGMT_POLICY_TYPE PolicyType;
union {
struct {
ULONG Containers;
} MaximumSize;
struct {
ULONG Containers;
} MinimumSize;
struct {
ULONG SizeInBytes;
} NewContainerSize;
struct {
ULONG AbsoluteGrowthInContainers;
ULONG RelativeGrowthPercentage;
} GrowthRate;
struct {
ULONG MinimumAvailablePercentage;
ULONG MinimumAvailableContainers;
} LogTail;
struct {
ULONG Percentage;
} AutoShrink;
struct {
ULONG Enabled;
} AutoGrow;
struct {
USHORT PrefixLengthInBytes;
WCHAR PrefixString[1];
} NewContainerPrefix;
struct {
ULONGLONG NextContainerSuffix;
} NewContainerSuffix;
struct {
USHORT ExtensionLengthInBytes;
WCHAR ExtensionString[1];
} NewContainerExtension;
} PolicyParameters;
} CLFS_MGMT_POLICY, *PCLFS_MGMT_POLICY;
Member
Version
Die Version der CLFS_MGMT_POLICY-Struktur . Legen Sie dies auf CLFS_MGMT_POLICY_VERSION fest.
LengthInBytes
Die Länge der CLFS_MGMT_POLICY-Struktur .
PolicyFlags
Die Flags, die für diese instance der CLFS_MGMT_POLICY-Struktur gelten. Das einzige Flag, das für dieses Release implementiert wurde, ist LOG_POLICY_OVERWRITE, das angibt, dass bei der Installation der Richtlinie die Richtlinie desselben Typs ersetzt wird, sofern bereits eine solche Richtlinie vorhanden ist.
PolicyType
Ein Wert der CLFS_MGMT_POLICY_TYPE-Enumeration, der den Typ dieser instance der CLFS_MGMT_POLICY-Struktur bereitstellt.
PolicyParameters
Die Union, die detaillierte Informationen zu diesem instance der CLFS_MGMT_POLICY-Struktur bereitstellt.
PolicyParameters.MaximumSize
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyMaximumSize ist.
PolicyParameters.MaximumSize.Containers
Die maximale Anzahl von Containern, die vom Protokoll verwendet werden.
PolicyParameters.MinimumSize
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyMinimumSize ist.
PolicyParameters.MinimumSize.Containers
Die Mindestanzahl von Containern, die vom Protokoll verwendet werden.
PolicyParameters.NewContainerSize
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyNewContainerSize ist.
PolicyParameters.NewContainerSize.SizeInBytes
Die Größe der einzelnen Container des Protokolls.
PolicyParameters.GrowthRate
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyGrowthRate ist.
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
Die Anzahl der Container, die hinzugefügt werden sollen, wenn die Größe des Protokolls erhöht wird. Wenn das RelativeGrowthPercentage-Element ungleich null ist, muss AbsoluteGrowthInContainers null sein.
PolicyParameters.GrowthRate.RelativeGrowthPercentage
Der Prozentsatz, um den die Größe des Protokolls erhöht werden soll, wenn das Protokoll wächst, ausgedrückt als Zahl zwischen 0 und 100. Wenn das Protokoll beispielsweise aus 32 Containern bestand und RelativeGrowthPercentage zehn war, würde es, wenn das Protokoll vergrößert werden musste, um drei Container vergrößert (32 * 10 Prozent, gerundet auf die nächste ganze Zahl). Wenn das AbsoluteGrowthInContainers-Element ungleich null ist, muss RelativeGrowthPercentage null sein.
PolicyParameters.LogTail
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyLogTail ist.
PolicyParameters.LogTail.MinimumAvailablePercentage
Wenn die CLFS-Verwaltung den Client benachrichtigt, sein Protokollfragment zu verschieben, wird angegeben, dass das Tail in eine LSN verschoben wird, bei der mindestens MinimumAvailablePercentage prozentual des Protokolls frei bleibt. Wenn das MinimumAvailableContainers-Element ungleich null ist, muss MinimumAvailablePercentage null sein.
PolicyParameters.LogTail.MinimumAvailableContainers
Wenn die CLFS-Verwaltung den Client benachrichtigt, sein Protokollfragment zu verschieben, wird angegeben, dass das Tail in eine LSN verschoben wird, die mindestens MinimumAvailableContainers-Container frei lässt. Wenn das MinimumAvailablePercentage-Element ungleich null ist, muss MinimumAvailableContainers null sein.
PolicyParameters.AutoShrink
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyAutoShrink ist.
PolicyParameters.AutoShrink.Percentage
Wenn der Prozentsatz des freien Speicherplatzes im Protokoll Prozent erreicht, wird das Protokoll verkleinern. Der Prozentsatz wird als Zahl zwischen 0 und 100 ausgedrückt, sodass ein Wert von 25 25 Prozent bedeuten würde.
PolicyParameters.AutoGrow
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyAutoGrow ist.
PolicyParameters.AutoGrow.Enabled
Ein numerischer Wert, der bestimmt, ob die automatische Protokollvergrößerung aktiviert ist. Jeder Wert ungleich Null ermöglicht die automatische Vergrößerung.
PolicyParameters.NewContainerPrefix
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyNewContainerPrefix ist.
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
Die Länge des PrefixString-Elements in Bytes.
PolicyParameters.NewContainerPrefix.PrefixString[1]
Eine Breitzeichenzeichenfolge, die den vollständigen Pfad zu dem Verzeichnis enthält, in dem sich die Container des Protokolls befinden, sowie ein Präfix, das als Teil des Dateinamens für jeden Container im Protokoll verwendet wird.
PolicyParameters.NewContainerSuffix
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyNewContainerSuffix ist.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
Die Zahl, die als Suffix des Dateinamens für den nächsten Container im Protokoll verwendet werden soll. Um den Dateinamen zu bilden, wird die Zahl in eine Zeichenfolge von Dezimalstellen konvertiert und an die Präfixzeichenfolge angefügt. Die Zahl wird für den Dateinamen jedes nachfolgenden Containers erhöht.
PolicyParameters.NewContainerExtension
Die Struktur, die detaillierte Informationen zu einer Richtlinie bereitstellt, deren PolicyTypeClfsMgmtPolicyNewContainerExtension ist.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
Die Länge des ExtensionString-Elements in Bytes.
PolicyParameters.NewContainerExtension.ExtensionString[1]
Eine Breitzeichenzeichenfolge, die die Erweiterung des Dateinamens für jeden Container im Protokoll enthält. Containerdateinamen werden im Format [prefix][suffix][.extension] erstellt. Eine Erweiterung ist optional. Die Standarderweiterung ist die leere Zeichenfolge.
Hinweise
Die Art und Weise, wie eine CLFS_MGMT_POLICY-Struktur interpretiert wird, hängt vom Typ der Richtlinie ab, die die Struktur enthält.
Sie können Richtlinien angeben, die angeben, wie das Protokoll verwaltet wird. Jede Richtlinie ist eine instance der CLFS_MGMT_POLICY-Struktur, aber die Struktur wird je nach Richtlinientyp unterschiedlich interpretiert. CLFS verwendet die Informationen, die Sie in den Richtlinien angegeben haben, um die Verwaltung des Protokolls anzupassen.
Wenn Sie eine CLFS_MGMT_POLICY-Struktur erstellen, deren PolicyTypeClfsMgmtPolicyNewContainerPrefix ist, müssen Sie genügend Speicherplatz für die Zeichenfolge PolicyParameters.NewContainerPrefix.PrefixString zuweisen.
Sie können nur eine Richtlinie installieren, deren Richtlinientyp im PolicyType-WertClfsMgmtPolicyNewContainerSize ist, bevor container im Protokoll vorhanden sind. Sie können andere Richtlinien ändern, nachdem das Protokoll vorhanden ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |