Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
[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 a través de técnicas más sencillas y disponibles con mayor facilidad. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para obtener más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional.]
Contiene la información necesaria al modificar los parámetros de registro y el modo de registro para un administrador de recursos secundario.
Syntax
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;
Members
Flags
Parámetros de registro que se van a establecer.
Este miembro puede ser uno o varios de los siguientes valores.
| Importancia | Meaning |
|---|---|
|
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 al RM que cambie el nombre a 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 por el porcentaje del tamaño del 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 al 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 se apague y reinicie el RM). |
|
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 indica al RM que se restablezca a sí mismo 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 con respecto a 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 relación con 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 está libre en cualquier momento dado.
Reserved
Reservado.
LoggingMode
Modo de registro actual.
| Importancia | Meaning |
|---|---|
|
Se usa el registro simple. |
|
Se usa el registro completo |
Requisitos
| Requirement | Importancia |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| Header | winioctl.h (incluya Windows.h) |