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><.
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 |