struttura CLFS_MGMT_POLICY (wdm.h)
La struttura CLFS_MGMT_POLICY contiene una descrizione di un criterio per la gestione di un log CLFS.
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
Versione della struttura CLFS_MGMT_POLICY . Impostare questa opzione su CLFS_MGMT_POLICY_VERSION.
LengthInBytes
Lunghezza della struttura CLFS_MGMT_POLICY .
PolicyFlags
Flag che si applicano a questa istanza della struttura CLFS_MGMT_POLICY . L'unico flag implementato per questa versione è LOG_POLICY_OVERWRITE, che indica che quando il criterio è installato, sostituirà il criterio dello stesso tipo, se tale criterio esiste già.
PolicyType
Valore dell'enumerazione CLFS_MGMT_POLICY_TYPE che fornisce il tipo di questa istanza della struttura CLFS_MGMT_POLICY .
PolicyParameters
Unione che fornisce informazioni dettagliate su questa istanza della struttura CLFS_MGMT_POLICY .
PolicyParameters.MaximumSize
Struttura che fornisce informazioni dettagliate su un criterio il cui criterioType è ClfsMgmtPolicyMaximumSize.
PolicyParameters.MaximumSize.Containers
Numero massimo di contenitori usati dal log.
PolicyParameters.MinimumSize
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio è ClfsMgmtPolicyMinimumSize.
PolicyParameters.MinimumSize.Containers
Numero minimo di contenitori usati dal log.
PolicyParameters.NewContainerSize
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio è ClfsMgmtPolicyNewContainerSize.
PolicyParameters.NewContainerSize.SizeInBytes
Dimensioni di ognuno dei contenitori del log.
PolicyParameters.GrowthRate
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio è ClfsMgmtPolicyGrowthRate.
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
Numero di contenitori che devono essere aggiunti quando le dimensioni del log sono aumentate. Se il membro RelativeGrowthPercentage è diverso da zero, AbsoluteGrowthInContainers deve essere zero.
PolicyParameters.GrowthRate.RelativeGrowthPercentage
Percentuale in base alla quale le dimensioni del log devono aumentare quando il log aumenta, espresso come numero compreso tra zero e 100. Ad esempio, se il log è costituito da 32 contenitori e RelativeGrowthPercentage era dieci, quindi, quando il log necessario per crescere, aumenterebbe di tre (32 * 10 per cento, arrotondati fino al numero intero più vicino). Se il membro AbsoluteGrowthInContainers è diverso da zero, RelativeGrowthPercentage deve essere zero.
PolicyParameters.LogTail
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio è ClfsMgmtPolicyLogTail.
PolicyParameters.LogTail.MinimumAvailablePercentage
Quando la gestione CLFS notifica al client di spostare la coda di log, verrà specificato che la coda verrà spostata in un LSN che lascia almeno minimumAvailablePercentage % del log libero. Se il membro MinimumAvailableContainers è diverso da zero, MinimumAvailablePercentage deve essere zero.
PolicyParameters.LogTail.MinimumAvailableContainers
Quando la gestione CLFS notifica al client di spostare la coda del log, specifica che la coda verrà spostata in un LSN che lascia gratuitamente almeno i contenitori MinimumAvailableContainers . Se il membro MinimumAvailablePercentage è diverso da zero, MinimumAvailableContainers deve essere zero.
PolicyParameters.AutoShrink
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio èClfsMgmtPolicyAutoShrink.
PolicyParameters.AutoShrink.Percentage
Quando la percentuale di spazio libero nel log raggiunge percentuale, il log verrà ridotto. La percentuale viene espressa come numero compreso tra 0 e 100, quindi un valore pari al 25 significa 25%.
PolicyParameters.AutoGrow
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio è ClfsMgmtPolicyAutoGrow.
PolicyParameters.AutoGrow.Enabled
Valore numerico che determina se la crescita automatica dei log è abilitata. Qualsiasi valore diverso da zero consente la crescita automatica.
PolicyParameters.NewContainerPrefix
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio è ClfsMgmtPolicyNewContainerPrefix.
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
Lunghezza, in byte, del membro PrefixString .
PolicyParameters.NewContainerPrefix.PrefixString[1]
Stringa di caratteri wide che contiene il percorso completo della directory in cui risiedono i contenitori del log, nonché un prefisso che verrà usato come parte del nome file per ogni contenitore nel log.
PolicyParameters.NewContainerSuffix
Struttura che fornisce informazioni dettagliate su un criterio il cui criterio è ClfsMgmtPolicyNewContainerSuffix.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
Numero da usare come suffisso del nome del file per il contenitore successivo nel log. Per formare il nome del file, il numero viene convertito in una stringa di cifre decimali e accodato alla stringa di prefisso. Il numero viene incrementato per il nome del file di ogni contenitore successivo.
PolicyParameters.NewContainerExtension
Struttura che fornisce informazioni dettagliate su un criterio il cui CriterioType è ClfsMgmtPolicyNewContainerExtension.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
Lunghezza, in byte, del membro ExtensionString .
PolicyParameters.NewContainerExtension.ExtensionString[1]
Stringa di caratteri wide contenente l'estensione per il nome del file per ogni contenitore nel log. I nomi di file contenitore vengono compilati usando il formato [prefisso][suffisso][.extension]. Un'estensione è facoltativa. L'estensione predefinita è la stringa vuota.
Commenti
Il modo in cui viene interpretata una struttura CLFS_MGMT_POLICY dipende dal tipo di criterio che la struttura contiene.
È possibile fornire criteri che specificano come verrà gestito il log. Ogni criterio è un'istanza della struttura CLFS_MGMT_POLICY , ma la struttura viene interpretata in modo diverso a seconda del tipo di criterio. CLFS usa le informazioni fornite nei criteri per personalizzare il modo in cui gestisce il log.
Quando si crea una struttura CLFS_MGMT_POLICY il cui criterioType è ClfsMgmtPolicyNewContainerPrefix, assicurarsi di allocare spazio sufficiente per contenere la stringa PolicyParameters.NewContainerPrefix.PrefixString .
È possibile installare un criterio il cui tipo di criterio specificato nel valore PolicyType è ClfsMgmtPolicyNewContainerSize prima che siano presenti contenitori nel log. È possibile modificare altri criteri dopo l'esistenza del log.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |