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 información sobre el administrador de recursos (RM).
Syntax
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;
Members
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 (LSN) más antiguo usado actualmente por 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 registro, en bytes.
HighestVirtualClock
Marca de tiempo más alta asociada a un registro de registro.
LogContainerCount
Número de contenedores de registro.
LogContainerCountMax
Número máximo de contenedores de registro.
LogContainerCountMin
Número mínimo de contenedores permitidos en el registro.
LogGrowthIncrement
La cantidad en la 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 siguientes valores.
| Importancia | Meaning |
|---|---|
|
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 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. |
LoggingMode
Modo de registro actual.
| Importancia | Meaning |
|---|---|
|
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 lleno.
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
| 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) |