struttura CLFS_MGMT_POLICY (clfsmgmt.h)

La struttura CLFS_MGMT_POLICY specifica un criterio di gestione CLFS (Common Log File System). Il membro PolicyType specifica i membri usati per un criterio.

Sintassi

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;

Members

Version

Specifica la versione delle intestazioni di Log Manager compilate dall'applicazione.

Impostare questa opzione su CLFS_MGMT_POLICY_VERSION.

LengthInBytes

Specifica la lunghezza dell'intera struttura.

PolicyFlags

Riservato. Specificare zero.

PolicyType

Specifica i membri usati per un criterio specifico. I valori validi vengono specificati da CLFS_MGMT_POLICY_TYPE.

PolicyParameters

Specifica i criteri specifici descritti da questa struttura.

PolicyParameters.MaximumSize

Specifica le dimensioni massime di un log.

PolicyParameters.MaximumSize.Containers

Specifica le dimensioni massime del log come numero di contenitori. Non esiste alcun valore massimo predefinito.

PolicyParameters.MinimumSize

Specifica le dimensioni minime di un log.

PolicyParameters.MinimumSize.Containers

Specifica le dimensioni minime del log come numero di contenitori. La dimensione minima è due (2) contenitori.

PolicyParameters.NewContainerSize

Controlla le dimensioni di un nuovo contenitore.

PolicyParameters.NewContainerSize.SizeInBytes

Specifica le dimensioni, in byte, di tutti i nuovi contenitori creati.

PolicyParameters.GrowthRate

Controlla la frequenza di crescita di un log. Il tasso di crescita può essere una percentuale relativa o un numero assoluto di contenitori aggiunti, ma non entrambi. I valori validi sono zero (0) e maggiori. Specificare zero (0) per indicare che il log non è in grado di aumentare le dimensioni.

PolicyParameters.GrowthRate.AbsoluteGrowthInContainers

Specifica il tasso di crescita come numero assoluto di contenitori. Il valore predefinito di questo membro è due (2).

PolicyParameters.GrowthRate.RelativeGrowthPercentage

Specifica il tasso di crescita come percentuale relativa. Non esiste alcun valore predefinito per questo membro.

PolicyParameters.LogTail

Controlla la quantità di spazio che LOG_TAIL_ADVANCE_CALLBACK richieste. Il valore è una percentuale relativa o un numero assoluto di byte, ma non entrambi. Il valore viene sempre arrotondato al contenitore più vicino. Specificare zero per indicare che non viene eseguita alcuna azione per avanzare la coda del log di base.

PolicyParameters.LogTail.MinimumAvailablePercentage

Specifica la quantità di spazio richiesta come percentuale dell'intero log. La quantità minima richiesta libera spazio in un contenitore.

PolicyParameters.LogTail.MinimumAvailableContainers

Specifica la quantità di spazio richiesta come numero assoluto di contenitori.

PolicyParameters.AutoShrink

Controlla la tempistica della funzionalità di compattazione dei log. Questo valore rappresenta la percentuale di spazio libero che deve esistere per attivare l'operazione di compattazione automatica. Il log non può essere ridotto a una dimensione inferiore al valore specificato dal criterio ClfsMgmtPolicyMinimumSize .

PolicyParameters.AutoShrink.Percentage

Specifica la percentuale per compattare il log. Non è previsto alcun valore predefinito.

PolicyParameters.AutoGrow

Controlla la funzionalità di crescita automatica. Se l'aumento automatico è abilitato, il log cresce in base al valore del membro GrowthRate ed è limitato dal valore del membro MaximumSize quando il log raggiunge uno stato in cui uno o nessun contenitore è gratuito.

PolicyParameters.AutoGrow.Enabled

Specifica se i criteri di crescita automatica sono abilitati. Specificare zero per disabilitare i criteri di crescita automatica. L'impostazione predefinita è disabilitata.

PolicyParameters.NewContainerPrefix

Controlla il prefisso assegnato a un nuovo contenitore.

PolicyParameters.NewContainerPrefix.PrefixLengthInBytes

Specifica la lunghezza di PrefixString.

PolicyParameters.NewContainerPrefix.PrefixString[1]

Specifica la stringa di prefisso. Questa stringa deve includere un percorso completo della directory in cui vengono creati i contenitori e un prefisso per il nome del contenitore.

Il percorso predefinito del contenitore è la directory che contiene il log di base. Il valore predefinito è "Contenitore". Il contenitore di log viene creato con il nome Nome del prefisso <predefinito><> log><.

Nota Common Log File System (CLFS) determina il valore di <Number>.
 

PolicyParameters.NewContainerSuffix

Controlla il suffisso assegnato a un nuovo contenitore.

PolicyParameters.NewContainerSuffix.NextContainerSuffix

Specifica il suffisso specificato in un nuovo contenitore.

PolicyParameters.NewContainerExtension

Controlla l'estensione assegnata a un nuovo contenitore.

PolicyParameters.NewContainerExtension.ExtensionLengthInBytes

Specifica la lunghezza di ExtensionString.

PolicyParameters.NewContainerExtension.ExtensionString[1]

Specifica l'estensione specificata nel file contenitore.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Intestazione clfsmgmt.h

Vedi anche

CLFS_MGMT_POLICY_TYPE