estructura CLFS_MGMT_POLICY (wdm.h)
La estructura CLFS_MGMT_POLICY contiene una descripción de una directiva para administrar un registro CLFS.
Sintaxis
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;
Miembros
Version
Versión de la estructura de CLFS_MGMT_POLICY . Establézcalo en CLFS_MGMT_POLICY_VERSION.
LengthInBytes
Longitud de la estructura CLFS_MGMT_POLICY .
PolicyFlags
Marcas que se aplican a esta instancia de la estructura CLFS_MGMT_POLICY . La única marca que se ha implementado para esta versión es LOG_POLICY_OVERWRITE, lo que indica que cuando se instala la directiva, reemplazará la directiva del mismo tipo, si dicha directiva ya existe.
PolicyType
Valor de la enumeración CLFS_MGMT_POLICY_TYPE que proporciona el tipo de esta instancia de la estructura CLFS_MGMT_POLICY .
PolicyParameters
Unión que proporciona información detallada sobre esta instancia de la estructura CLFS_MGMT_POLICY .
PolicyParameters.MaximumSize
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyMaximumSize.
PolicyParameters.MaximumSize.Containers
Número máximo de contenedores que usará el registro.
PolicyParameters.MinimumSize
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyMinimumSize.
PolicyParameters.MinimumSize.Containers
Número mínimo de contenedores que usará el registro.
PolicyParameters.NewContainerSize
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyNewContainerSize.
PolicyParameters.NewContainerSize.SizeInBytes
Tamaño de cada uno de los contenedores del registro.
PolicyParameters.GrowthRate
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyGrowthRate.
PolicyParameters.GrowthRate.AbsoluteGrowthInContainers
Número de contenedores que se deben agregar cuando se aumenta el tamaño del registro. Si el miembro RelativeGrowthPercentage es distinto de cero, AbsoluteGrowthInContainers debe ser cero.
PolicyParameters.GrowthRate.RelativeGrowthPercentage
Porcentaje por el que el tamaño del registro debe aumentar cuando crece el registro, expresado como un número entre cero y 100. Por ejemplo, si el registro constaba de 32 contenedores y RelativeGrowthPercentage era diez, entonces, cuando el registro necesitaba crecer, crecería en tres (32 * 10 por ciento, redondeado hacia abajo hasta el entero más cercano). Si el miembro AbsoluteGrowthInContainers es distinto de cero, RelativeGrowthPercentage debe ser cero.
PolicyParameters.LogTail
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyLogTail.
PolicyParameters.LogTail.MinimumAvailablePercentage
Cuando la administración de CLFS notifica al cliente que mueva su cola de registro, especificará que la cola se mueva a un LSN que deje al menos el porcentaje MinimumAvailablePercentage del registro libre. Si el miembro MinimumAvailableContainers es distinto de cero, MinimumAvailablePercentage debe ser cero.
PolicyParameters.LogTail.MinimumAvailableContainers
Cuando la administración de CLFS notifica al cliente que mueva su cola de registro, especificará que la cola se mueva a un LSN que deje al menos los contenedores MinimumAvailableContainers libres. Si el miembro MinimumAvailablePercentage es distinto de cero, MinimumAvailableContainers debe ser cero.
PolicyParameters.AutoShrink
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyAutoShrink.
PolicyParameters.AutoShrink.Percentage
Cuando el porcentaje de espacio libre en el registro alcance Porcentaje, el registro se reducirá. El porcentaje se expresa como un número comprendido entre 0 y 100, por lo que un valor de 25 significaría un 25 por ciento.
PolicyParameters.AutoGrow
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyAutoGrow.
PolicyParameters.AutoGrow.Enabled
Valor numérico que determina si el crecimiento automático del registro está habilitado. Cualquier valor distinto de cero permite el crecimiento automático.
PolicyParameters.NewContainerPrefix
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyNewContainerPrefix.
PolicyParameters.NewContainerPrefix.PrefixLengthInBytes
Longitud, en bytes, del miembro PrefixString .
PolicyParameters.NewContainerPrefix.PrefixString[1]
Cadena de caracteres anchos que contiene la ruta de acceso completa al directorio donde residen los contenedores del registro, así como un prefijo que se usará como parte del nombre de archivo para cada contenedor del registro.
PolicyParameters.NewContainerSuffix
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyNewContainerSuffix.
PolicyParameters.NewContainerSuffix.NextContainerSuffix
Número que se va a usar como sufijo del nombre de archivo para el siguiente contenedor del registro. Para formar el nombre de archivo, el número se convierte en una cadena de dígitos decimales y se anexa a la cadena de prefijo. El número se incrementa para el nombre de archivo de cada contenedor posterior.
PolicyParameters.NewContainerExtension
Estructura que proporciona información detallada sobre una directiva cuyo PolicyType es ClfsMgmtPolicyNewContainerExtension.
PolicyParameters.NewContainerExtension.ExtensionLengthInBytes
Longitud, en bytes, del miembro ExtensionString .
PolicyParameters.NewContainerExtension.ExtensionString[1]
Cadena de caracteres anchos que contiene la extensión para el nombre de archivo de cada contenedor del registro. Los nombres de archivo de contenedor se compilan con el formato [prefijo][sufijo][.extension]. Una extensión es opcional. La extensión predeterminada es la cadena vacía.
Comentarios
La forma en que se interpreta una estructura de CLFS_MGMT_POLICY depende del tipo de directiva que contiene la estructura.
Puede proporcionar directivas que especifiquen cómo se administrará el registro. Cada directiva es una instancia de la estructura de CLFS_MGMT_POLICY , pero la estructura se interpreta de forma diferente en función del tipo de directiva. CLFS usa la información que proporcionó en las directivas para adaptar la forma en que administra el registro.
Al crear una estructura de CLFS_MGMT_POLICY cuyo PolicyType es ClfsMgmtPolicyNewContainerPrefix, asegúrese de asignar espacio suficiente para contener la cadena PolicyParameters.NewContainerPrefix.PrefixString .
Solo puede instalar una directiva cuyo tipo de directiva se especifica en el valor PolicyType es ClfsMgmtPolicyNewContainerSize antes de que haya contenedores en el registro. Puede cambiar otras directivas después de que exista el registro.
Requisitos
| Requisito | Valor |
|---|---|
| Header | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |