estrutura CLFS_MGMT_POLICY (clfsmgmt.h)
A estrutura CLFS_MGMT_POLICY especifica uma política de gerenciamento CLFS (Common Log File System). O membro PolicyType especifica os membros usados para uma política.
Sintaxe
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;
Membros
Version
Especifica a versão dos cabeçalhos do gerenciador de logs com os quais o aplicativo é compilado.
Defina isso como CLFS_MGMT_POLICY_VERSION.
LengthInBytes
Especifica o comprimento de toda a estrutura.
PolicyFlags
Reservado. Especifique zero.
PolicyType
Especifica os membros usados para uma política específica. Os valores válidos são especificados por CLFS_MGMT_POLICY_TYPE.
PolicyParameters
Especifica a política específica que essa estrutura descreve.
PolicyParameters.MaximumSize
Especifica o tamanho máximo de um log.
PolicyParameters.MaximumSize.Containers
Especifica o tamanho máximo do log como um número de contêineres. Não há nenhum valor máximo padrão.
PolicyParameters.MinimumSize
Especifica o tamanho mínimo de um log.
PolicyParameters.MinimumSize.Containers
Especifica o tamanho mínimo do log como um número de contêineres. O tamanho mínimo é de dois (2) contêineres.
PolicyParameters.NewContainerSize
Controla o tamanho de um novo contêiner.
PolicyParameters.NewContainerSize.SizeInBytes
Especifica o tamanho, em bytes, de todos os novos contêineres criados.
PolicyParameters.GrowthRate
Controla a taxa de crescimento de um log. A taxa de crescimento pode ser um percentual relativo ou um número absoluto de contêineres adicionados, mas não ambos. Os valores válidos são zero (0) e superiores. Especifique zero (0) para indicar que o log não deve aumentar de tamanho.
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
Especifica a taxa de crescimento como um número absoluto de contêineres. O valor padrão desse membro é dois (2).
PolicyParameters.GrowthRate.RelativeGrowthPercentage
Especifica a taxa de crescimento como uma porcentagem relativa. Não há nenhum valor padrão para esse membro.
PolicyParameters.LogTail
Controla a quantidade de espaço que LOG_TAIL_ADVANCE_CALLBACK solicitações. O valor é uma porcentagem relativa ou um número absoluto de bytes, mas não ambos. O valor é sempre arredondado para cima até o contêiner mais próximo. Especifique zero para indicar que nenhuma ação é tomada para avançar a parte final do log base.
PolicyParameters.LogTail.MinimumAvailablePercentage
Especifica a quantidade de espaço solicitada como uma porcentagem de todo o log. O valor mínimo solicitado libera espaço em um contêiner.
PolicyParameters.LogTail.MinimumAvailableContainers
Especifica a quantidade de espaço solicitada como um número absoluto de contêineres.
PolicyParameters.AutoShrink
Controla o tempo do recurso de redução de log. Esse valor representa a porcentagem de espaço livre que deve existir para disparar a operação de redução automática. O log não pode ser reduzido para um tamanho menor que o valor especificado pela política ClfsMgmtPolicyMinimumSize .
PolicyParameters.AutoShrink.Percentage
Especifica o percentual pelo qual reduzir o log. Nenhum valor padrão.
PolicyParameters.AutoGrow
Controla o recurso de crescimento automático. Se o aumento automático estiver habilitado, o log aumentará de acordo com o valor do membro GrowthRate e será limitado pelo valor do membro MaximumSize quando o log atingir um estado em que um ou nenhum contêiner é gratuito.
PolicyParameters.AutoGrow.Enabled
Especifica se a política de crescimento automático está habilitada. Especifique zero para desabilitar a política de crescimento automático. Por padrão, ela fica desabilitada.
PolicyParameters.NewContainerPrefix
Controla o prefixo que é dado a um novo contêiner.
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
Especifica o comprimento de PrefixString.
PolicyParameters.NewContainerPrefix.PrefixString[1]
Especifica a cadeia de caracteres de prefixo. Essa cadeia de caracteres deve incluir um caminho completo para o diretório em que os contêineres são criados e um prefixo para o nome do contêiner.
O caminho padrão para o contêiner é o diretório que contém o log base. O valor padrão é "Contêiner". O contêiner de log é criado com o nome <Nome do Número> de Prefixo><Padrão de Log><.
PolicyParameters.NewContainerSuffix
Controla o sufixo fornecido a um novo contêiner.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
Especifica o sufixo fornecido a um novo contêiner.
PolicyParameters.NewContainerExtension
Controla a extensão que é fornecida a um novo contêiner.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
Especifica o comprimento de ExtensionString.
PolicyParameters.NewContainerExtension.ExtensionString[1]
Especifica a extensão fornecida ao arquivo de contêiner.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 R2 [somente aplicativos da área de trabalho] |
| Cabeçalho | clfsmgmt.h |