estructura TXFS_QUERY_RM_INFORMATION (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 información sobre el Administrador de recursos (RM).
Sintaxis
typedef struct _TXFS_QUERY_RM_INFORMATION {
DWORD BytesRequired;
DWORDLONG TailLsn;
DWORDLONG CurrentLsn;
DWORDLONG ArchiveTailLsn;
DWORDLONG LogContainerSize;
LARGE_INTEGER HighestVirtualClock;
DWORD LogContainerCount;
DWORD LogContainerCountMax;
DWORD LogContainerCountMin;
DWORD LogGrowthIncrement;
DWORD LogAutoShrinkPercentage;
DWORD Flags;
WORD LoggingMode;
WORD Reserved;
DWORD RmState;
DWORDLONG LogCapacity;
DWORDLONG LogFree;
DWORDLONG TopsSize;
DWORDLONG TopsUsed;
DWORDLONG TransactionCount;
DWORDLONG OnePCCount;
DWORDLONG TwoPCCount;
DWORDLONG NumberLogFileFull;
DWORDLONG OldestTransactionAge;
GUID RMName;
DWORD TmLogPathOffset;
} TXFS_QUERY_RM_INFORMATION, *PTXFS_QUERY_RM_INFORMATION;
Miembros
BytesRequired
Si FSCTL_TXFS_QUERY_RM_INFORMATION devuelve ERROR_BUFFER_TOO_SMALL, este miembro especifica el número mínimo de bytes necesarios para devolver la información solicitada, incluido el carácter de terminación NULL .
TailLsn
Número de secuencia de registro más antiguo (LSN) usado actualmente por el RM.
CurrentLsn
El LSN usado más recientemente por el RM en su registro.
ArchiveTailLsn
LSN del final del archivo del registro.
LogContainerSize
Tamaño real de un contenedor de registros, en bytes.
HighestVirtualClock
Marca de tiempo más alta asociada a un registro.
LogContainerCount
Número de contenedores de registro.
LogContainerCountMax
Número máximo de contenedores de registro.
LogContainerCountMin
El número mínimo de contenedores permitidos en el registro.
LogGrowthIncrement
La cantidad que aumentará el registro, que es un número de contenedores o un porcentaje del tamaño del registro; el tipo de crecimiento utilizado se especifica mediante las marcas establecidas en el miembro Flags .
LogAutoShrinkPercentage
Si la directiva de reducción automática está activa, este miembro especifica la cantidad máxima permitida de espacio libre en el registro. Si este miembro es cero, la directiva de reducción automática no está activa.
Flags
Este miembro puede ser uno o varios de los valores siguientes.
| Valor | Significado |
|---|---|
|
Si se establece la marca, el registro de RM puede reducirse en la medida de lo posible. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Indica el tipo de valor en LogGrowthIncrement. Si se establece esta marca, LogGrowthIncrement es un número de contenedores. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT. |
|
Indica el tipo de valor en LogGrowthIncrement. Si se establece esta marca, LogGrowthIncrement es un porcentaje. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Indica que el registro de RM puede crecer sin límites. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Indica el estado actual de la marca de restablecimiento de RM. Si se establece, rm se restablecerá la próxima vez que se inicie. Esta marca solo es válida para las máquinas virtuales predeterminadas, no para las máquinas virtuales secundarias. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START. |
|
Indica el estado actual de la marca de restablecimiento de RM. Si se establece, rm no se restablecerá la próxima vez que se inicie. Esta marca solo es válida para las máquinas virtuales predeterminadas, no para las máquinas virtuales secundarias. Esta marca es mutuamente excluyente con TXFS_RM_FLAG_RESET_RM_AT_NEXT_START. |
|
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. |
LoggingMode
Modo de registro actual.
| Valor | Significado |
|---|---|
|
Se usa el registro simple. |
|
Se usa el registro completo |
Reserved
Reservado.
RmState
Estado del RM. Los valores válidos son los siguientes.
LogCapacity
Capacidad total del registro, en bytes.
LogFree
Número de bytes libres en el registro.
TopsSize
Tamaño del archivo $Tops, en bytes.
TopsUsed
Cantidad del archivo $Tops que está en uso, en bytes.
TransactionCount
Número de transacciones activas, en el momento en que se emitió la consulta.
OnePCCount
Número de operaciones de confirmación de una sola fase que se han producido en este RM.
TwoPCCount
Número de operaciones de confirmación en dos fases que se han producido en este RM.
NumberLogFileFull
Número de veces que el registro de este RM se ha llenado.
OldestTransactionAge
Longitud de la transacción activa más antigua, en milisegundos.
RMName
GUID que indica el nombre de este RM.
TmLogPathOffset
Desplazamiento desde el principio de esta estructura a una cadena Unicode terminada en NULL que contiene la ruta de acceso al registro de TM.
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 (incluye Windows.h) |