estructura TXFS_MODIFY_RM (winioctl.h)
[Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr mediante técnicas más sencillas y disponibles. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional].
Contiene la información necesaria cuando se modifican los parámetros de registro y el modo de registro de un administrador de recursos secundario.
Sintaxis
typedef struct _TXFS_MODIFY_RM {
DWORD Flags;
DWORD LogContainerCountMax;
DWORD LogContainerCountMin;
DWORD LogContainerCount;
DWORD LogGrowthIncrement;
DWORD LogAutoShrinkPercentage;
DWORDLONG Reserved;
WORD LoggingMode;
} TXFS_MODIFY_RM, *PTXFS_MODIFY_RM;
Miembros
Flags
Parámetros de registro que se van a establecer.
Este miembro puede ser uno o varios de los valores siguientes.
| Valor | Significado |
|---|---|
|
Si se establece esta marca, se usa el miembro LoggingMode de esta estructura. Si no se establece la marca, se omite el miembro LoggingMode . |
|
Si se establece esta marca, se indica a RM que cambie el nombre por sí mismo (creando un nuevo GUID). |
|
Si se establece esta marca, se usa el miembro LogContainerCountMax . Si no se establece la marca, se omite el miembro LogContainerCountMax . Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Si se establece esta marca, se usa el miembro LogContainerCountMin . Si no se establece la marca, se omite el miembro LogContainerCountMin . Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Si se establece esta marca, se usa el miembro LogGrowthIncrement . Si no se establece la marca, se omite el miembro LogGrowthIncrement . Esta marca indica que el registro debe crecer según el número de contenedores especificados en el miembro LogGrowthIncrement . Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT. |
|
Si se establece esta marca, se usa el miembro LogGrowthIncrement . Si no se establece la marca, se omite el miembro LogGrowthIncrement . Esta marca indica que el registro debe crecer según el porcentaje del tamaño de registro especificado en el miembro LogGrowthIncrement . Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Si se establece esta marca, se usa el miembro LogAutoShrinkPercentage . Si no se establece la marca, se omite LogAutoShrinkPercentage . |
|
Si se establece esta marca, se indica a RM que permita que su registro crezca sin límites. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Si se establece esta marca, se indica a RM que permita que su registro reduzca el registro a solo dos contenedores. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Si se establece esta marca, se indica al registro que aumente inmediatamente su tamaño al tamaño especificado en LogContainerCount. Si no se establece la marca, se omite LogContainerCount . |
|
Si se establece esta marca, se indica al registro que reduzca inmediatamente su tamaño al tamaño especificado en LogContainerCount. Si se establece esta marca y TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE , se indica al registro que se reduzca a su tamaño mínimo permitido y se omite LogContainerCount . |
|
Si se establece esta marca y TXFS_RM_FLAG_SHRINK_LOG , se indica al registro que se reduzca a su tamaño mínimo permitido y se omite LogContainerCount . Si se establece esta marca, se debe establecer el TXFS_RM_FLAG_SHRINK_LOG . |
|
Si se establece esta marca, se indica al registro que conserve los cambios en el disco. Si no se establece esta marca, los cambios realizados son temporales (es decir, hasta que rm se apague y reinicie). |
|
Esta marca solo es válida para las máquinas virtuales predeterminadas, no para las máquinas virtuales secundarias. Si se establece esta marca, se le indica a RM que se restablezca la próxima vez que se inicie. Se eliminan el registro y los metadatos asociados. |
|
Esta marca solo es válida para las máquinas virtuales predeterminadas, no para las máquinas virtuales secundarias. Si se establece esta marca, se cancela una llamada anterior a FSCTL_TXFS_MODIFY_RM con la marca TXFS_RM_FLAG_RESET_RM_AT_NEXT_START establecida. |
|
Indica que rm es preferir la coherencia de las transacciones sobre la disponibilidad del sistema. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_PREFER_AVAILABILITY y no es compatible con el RM predeterminado en el volumen del sistema. |
|
Indica que rm es preferir la disponibilidad del sistema en lugar de la coherencia de las transacciones. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_PREFER_CONSISTENCY y se fuerza por el RM predeterminado en el volumen del sistema. |
LogContainerCountMax
Tamaño máximo del registro, en contenedores.
LogContainerCountMin
Tamaño mínimo del registro, en contenedores.
LogContainerCount
Tamaño real del registro, en contenedores.
LogGrowthIncrement
Número de contenedores o porcentaje de espacio que se debe agregar al registro.
LogAutoShrinkPercentage
Porcentaje de espacio de registro que se va a mantener libre. Este miembro se usa cuando se usa la marca TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE e indica al registro que se reduzca automáticamente, por lo que no más de LogAutoShrinkPercentage del registro es gratuito en un momento dado.
Reserved
Reservado.
LoggingMode
Modo de registro actual.
| Valor | Significado |
|---|---|
|
Se usa un registro simple. |
|
Se usa el registro completo |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | winioctl.h (incluya Windows.h) |