Share via


CLFS_MGMT_POLICY-Struktur (clfsmgmt.h)

Die CLFS_MGMT_POLICY-Struktur gibt eine CLFS-Verwaltungsrichtlinie (Common Log File System) an. Das PolicyType-Element gibt die Member an, die für eine Richtlinie verwendet werden.

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

Gibt die Version der Protokoll-Manager-Header an, mit denen die Anwendung kompiliert wird.

Legen Sie dies auf CLFS_MGMT_POLICY_VERSION fest.

LengthInBytes

Gibt die Länge der gesamten Struktur an.

PolicyFlags

Reserviert. Geben Sie null an.

PolicyType

Gibt die Member an, die für eine bestimmte Richtlinie verwendet werden. Gültige Werte werden von CLFS_MGMT_POLICY_TYPE angegeben.

PolicyParameters

Gibt die spezifische Richtlinie an, die von dieser Struktur beschrieben wird.

PolicyParameters.MaximumSize

Gibt die maximale Größe eines Protokolls an.

PolicyParameters.MaximumSize.Containers

Gibt die maximale Größe des Protokolls als Anzahl von Containern an. Es gibt keinen Maximalen Standardwert.

PolicyParameters.MinimumSize

Gibt die Mindestgröße eines Protokolls an.

PolicyParameters.MinimumSize.Containers

Gibt die Mindestgröße des Protokolls als Anzahl von Containern an. Die Mindestgröße beträgt zwei (2) Container.

PolicyParameters.NewContainerSize

Steuert die Größe eines neuen Containers.

PolicyParameters.NewContainerSize.SizeInBytes

Gibt die Größe aller neu erstellten Container in Bytes an.

PolicyParameters.GrowthRate

Steuert die Wachstumsrate eines Protokolls. Die Wachstumsrate kann entweder ein relativer Prozentsatz oder eine absolute Anzahl von hinzugefügten Containern sein, aber nicht beides. Gültige Werte sind null (0) und höher. Geben Sie null (0) an, um anzugeben, dass das Protokoll nicht größer werden soll.

PolicyParameters.GrowthRate.AbsoluteGrowthInContainers

Gibt die Wachstumsrate als absolute Anzahl von Containern an. Der Standardwert dieses Members ist zwei (2).

PolicyParameters.GrowthRate.RelativeGrowthPercentage

Gibt die Wachstumsrate als relativen Prozentsatz an. Für dieses Element gibt es keinen Standardwert.

PolicyParameters.LogTail

Steuert den Speicherplatz, der anforderungen LOG_TAIL_ADVANCE_CALLBACK . Der Wert ist entweder ein relativer Prozentsatz oder eine absolute Anzahl von Bytes, aber nicht beides. Der Wert wird immer auf den nächsten Container aufgerundet. Geben Sie null an, um anzugeben, dass keine Aktion ausgeführt wird, um den Basisprotokollschwanz zu fördern.

PolicyParameters.LogTail.MinimumAvailablePercentage

Gibt den Speicherplatz an, der als Prozentsatz des gesamten Protokolls angefordert wird. Der angeforderte Mindestbetrag gibt Speicherplatz in einem Container frei.

PolicyParameters.LogTail.MinimumAvailableContainers

Gibt den Speicherplatz an, der als absolute Anzahl von Containern angefordert wird.

PolicyParameters.AutoShrink

Steuert das Timing des Features zum Verkleinern von Protokollen. Dieser Wert stellt den Prozentsatz des freien Speicherplatzes dar, der vorhanden sein muss, um den Vorgang zum automatischen Verkleinern auszulösen. Das Protokoll kann nicht auf eine Größe reduziert werden, die kleiner ist als der wert, der in der ClfsMgmtPolicyMinimumSize-Richtlinie angegeben ist.

PolicyParameters.AutoShrink.Percentage

Gibt den Prozentsatz an, um den das Protokoll verkleinern soll. Es ist kein Standardwert vorhanden.

PolicyParameters.AutoGrow

Steuert das Feature für automatisches Wachsen. Wenn die automatische Erweiterung aktiviert ist, wächst das Protokoll entsprechend dem Wert des GrowthRate-Members und wird durch den Wert des MaximumSize-Members begrenzt, wenn das Protokoll einen Zustand erreicht, in dem ein oder keine Container frei sind.

PolicyParameters.AutoGrow.Enabled

Gibt an, ob die Richtlinie für die automatische Erweiterung aktiviert ist. Geben Sie null an, um die Richtlinie für die automatische Erweiterung zu deaktivieren. Der Standardwert ist deaktiviert.

PolicyParameters.NewContainerPrefix

Steuert das Präfix, das einem neuen Container zugewiesen wird.

PolicyParameters.NewContainerPrefix.PrefixLengthInBytes

Gibt die Länge von PrefixString an.

PolicyParameters.NewContainerPrefix.PrefixString[1]

Gibt die Präfixzeichenfolge an. Diese Zeichenfolge sollte einen vollständigen Pfad zu dem Verzeichnis enthalten, in dem die Container erstellt werden, und ein Präfix für den Containernamen.

Der Standardpfad zum Container ist das Verzeichnis, das das Basisprotokoll enthält. Der Standardwert ist "Container". Der Protokollcontainer wird mit dem Namen <des Protokollstandardpräfixnummer>><>< erstellt.

Hinweis Das Common Log File System (CLFS) bestimmt den Wert von <Number>.
 

PolicyParameters.NewContainerSuffix

Steuert das Suffix, das einem neuen Container zugewiesen wird.

PolicyParameters.NewContainerSuffix.NextContainerSuffix

Gibt das Suffix an, das einem neuen Container zugewiesen wird.

PolicyParameters.NewContainerExtension

Steuert die Erweiterung, die einem neuen Container zugewiesen wird.

PolicyParameters.NewContainerExtension.ExtensionLengthInBytes

Gibt die Länge von ExtensionString an.

PolicyParameters.NewContainerExtension.ExtensionString[1]

Gibt die Erweiterung an, die der Containerdatei zugewiesen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 R2 [nur Desktop-Apps]
Kopfzeile clfsmgmt.h

Weitere Informationen

CLFS_MGMT_POLICY_TYPE