Partager via


CLFS_MGMT_POLICY structure (clfsmgmt.h)

La structure CLFS_MGMT_POLICY spécifie une stratégie de gestion CLFS (Common Log File System). Le membre PolicyType spécifie les membres utilisés pour une stratégie.

Syntaxe

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;

Membres

Version

Spécifie la version des en-têtes du gestionnaire de journaux avec lequel l’application est compilée.

Définissez cette valeur sur CLFS_MGMT_POLICY_VERSION.

LengthInBytes

Spécifie la longueur de la structure entière.

PolicyFlags

Réservé. Spécifiez zéro.

PolicyType

Spécifie les membres utilisés pour une stratégie spécifique. Les valeurs valides sont spécifiées par CLFS_MGMT_POLICY_TYPE.

PolicyParameters

Spécifie la stratégie spécifique décrite par cette structure.

PolicyParameters.MaximumSize

Spécifie la taille maximale d’un journal.

PolicyParameters.MaximumSize.Containers

Spécifie la taille maximale du journal sous la forme d’un nombre de conteneurs. Il n’existe aucune valeur maximale par défaut.

PolicyParameters.MinimumSize

Spécifie la taille minimale d’un journal.

PolicyParameters.MinimumSize.Containers

Spécifie la taille minimale du journal sous la forme d’un nombre de conteneurs. La taille minimale est de deux (2) conteneurs.

PolicyParameters.NewContainerSize

Contrôle la taille d’un nouveau conteneur.

PolicyParameters.NewContainerSize.SizeInBytes

Spécifie la taille, en octets, des nouveaux conteneurs créés.

PolicyParameters.GrowthRate

Contrôle le taux de croissance d’un journal. Le taux de croissance peut être un pourcentage relatif ou un nombre absolu de conteneurs ajoutés, mais pas les deux. Les valeurs valides sont zéro (0) et supérieures. Spécifiez zéro (0) pour indiquer que la taille du journal ne doit pas augmenter.

PolicyParameters.GrowthRate.AbsoluteGrowthInContainers

Spécifie le taux de croissance sous la forme d’un nombre absolu de conteneurs. La valeur par défaut de ce membre est deux (2).

PolicyParameters.GrowthRate.RelativeGrowthPercentage

Spécifie le taux de croissance sous forme de pourcentage relatif. Il n’existe aucune valeur par défaut pour ce membre.

PolicyParameters.LogTail

Contrôle la quantité d’espace qui LOG_TAIL_ADVANCE_CALLBACK demandes. La valeur est un pourcentage relatif ou un nombre absolu d’octets, mais pas les deux. La valeur est toujours arrondie au conteneur le plus proche. Spécifiez zéro pour indiquer qu’aucune action n’est effectuée pour avancer la fin du journal de base.

PolicyParameters.LogTail.MinimumAvailablePercentage

Spécifie la quantité d’espace demandée sous la forme d’un pourcentage du journal entier. La quantité minimale demandée libère de l’espace dans un conteneur.

PolicyParameters.LogTail.MinimumAvailableContainers

Spécifie la quantité d’espace demandée en tant que nombre absolu de conteneurs.

PolicyParameters.AutoShrink

Contrôle le minutage de la fonctionnalité de réduction des journaux. Cette valeur représente le pourcentage d’espace libre qui doit exister pour déclencher l’opération de réduction automatique. Le journal ne peut pas être réduit à une taille inférieure à la valeur spécifiée par la stratégie ClfsMgmtPolicyMinimumSize .

PolicyParameters.AutoShrink.Percentage

Spécifie le pourcentage de réduction du journal. Il n'y a pas de valeur par défaut.

PolicyParameters.AutoGrow

Contrôle la fonctionnalité de croissance automatique. Si la croissance automatique est activée, le journal augmente en fonction de la valeur du membre GrowthRate et est limité par la valeur du membre MaximumSize lorsque le journal atteint un état où un ou aucun conteneur n’est libre.

PolicyParameters.AutoGrow.Enabled

Spécifie si la stratégie de croissance automatique est activée. Spécifiez zéro pour désactiver la stratégie de croissance automatique. La valeur par défaut est désactivée.

PolicyParameters.NewContainerPrefix

Contrôle le préfixe donné à un nouveau conteneur.

PolicyParameters.NewContainerPrefix.PrefixLengthInBytes

Spécifie la longueur de PrefixString.

PolicyParameters.NewContainerPrefix.PrefixString[1]

Spécifie la chaîne de préfixe. Cette chaîne doit inclure un chemin d’accès complet au répertoire où les conteneurs sont créés, ainsi qu’un préfixe pour le nom du conteneur.

Le chemin d’accès par défaut au conteneur est le répertoire qui contient le journal de base. La valeur par défaut est « Container ». Le conteneur de journaux est créé avec le nom <du numéro> de préfixe><par défaut du journal><.

Note Le système CLFS (Common Log File System) détermine la valeur de <Number>.
 

PolicyParameters.NewContainerSuffix

Contrôle le suffixe donné à un nouveau conteneur.

PolicyParameters.NewContainerSuffix.NextContainerSuffix

Spécifie le suffixe donné à un nouveau conteneur.

PolicyParameters.NewContainerExtension

Contrôle l’extension donnée à un nouveau conteneur.

PolicyParameters.NewContainerExtension.ExtensionLengthInBytes

Spécifie la longueur d’ExtensionString.

PolicyParameters.NewContainerExtension.ExtensionString[1]

Spécifie l’extension donnée au fichier conteneur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 R2 [applications de bureau uniquement]
En-tête clfsmgmt.h

Voir aussi

CLFS_MGMT_POLICY_TYPE