TXFS_QUERY_RM_INFORMATION struttura (winioctl.h)
[Microsoft consiglia vivamente agli sviluppatori di usare mezzi alternativi per raggiungere le esigenze dell'applicazione. Molti scenari sviluppati da TxF possono essere ottenuti tramite tecniche più semplici e più leggibili. Inoltre, TxF potrebbe non essere disponibile nelle versioni future di Microsoft Windows. Per altre informazioni e alternative a TxF, vedere Alternative all'uso di NTFS transazionale.
Contiene informazioni su Resource Manager (RM).
Sintassi
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
Se FSCTL_TXFS_QUERY_RM_INFORMATION restituisce ERROR_BUFFER_TOO_SMALL, questo membro specifica il numero minimo di byte necessari per restituire le informazioni richieste, incluso il carattere di terminazione NULL .
TailLsn
Numero di sequenza di log meno recente (LSN) attualmente usato da RM.
CurrentLsn
LSN usato più di recente da RM nel relativo log.
ArchiveTailLsn
LSN della parte finale dell'archivio del log.
LogContainerSize
Dimensioni effettive di un contenitore di log, in byte.
HighestVirtualClock
Timestamp più alto associato a un record di log.
LogContainerCount
Numero di contenitori di log.
LogContainerCountMax
Numero massimo di contenitori di log.
LogContainerCountMin
Numero minimo di contenitori consentiti nel log.
LogGrowthIncrement
L'importo del log crescerà, ovvero un numero di contenitori o una percentuale delle dimensioni del log; il tipo di crescita usato viene specificato dai flag impostati nel membro Flags .
LogAutoShrinkPercentage
Se il criterio di compattazione automatica è attivo, questo membro specifica la quantità massima di spazio disponibile nel log. Se questo membro è zero, il criterio di compattazione automatica non è attivo.
Flags
Questo membro può essere uno o più dei valori seguenti.
| Valore | Significato |
|---|---|
|
Se il flag è impostato, il log di RM è autorizzato a compattare il più possibile. Questo flag è a vicenda esclusivo con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Indica il tipo di valore in LogGrowthIncrement. Se questo flag è impostato, LogGrowthIncrement è un numero di contenitori. Questo flag è a vicenda esclusivo con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT. |
|
Indica il tipo di valore in LogGrowthIncrement. Se questo flag è impostato, LogGrowthIncrement è una percentuale. Questo flag è a vicenda esclusivo con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Indica che il log di RM può crescere senza limiti. Questo flag è a vicenda esclusivo con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Indica lo stato corrente del flag di reimpostazione RM. Se questa operazione è impostata, l'RM verrà reimpostato al successivo avvio. Questo flag è valido solo per le macchine virtuali predefinite, non per le macchine virtuali secondarie. Questo flag è a vicenda esclusivo con TXFS_RM_FLAG_DO_NOT_RESET_RM_AT_NEXT_START. |
|
Indica lo stato corrente del flag di reimpostazione RM. Se questa operazione è impostata, l'RM non verrà reimpostato al successivo avvio. Questo flag è valido solo per le macchine virtuali predefinite, non per le macchine virtuali secondarie. Questo flag è a vicenda esclusivo con TXFS_RM_FLAG_RESET_RM_AT_NEXT_START. |
|
Indica che RM è quello di preferire la coerenza delle transazioni rispetto alla disponibilità del sistema. Questo flag è a vicenda esclusivo con TXFS_RM_FLAG_PREFER_AVAILABILITY e non è supportato dal rm predefinito nel volume di sistema. |
|
Indica che RM è quello di preferire la disponibilità di sistema rispetto alla coerenza delle transazioni. Questo flag si escludono a vicenda con TXFS_RM_FLAG_PREFER_CONSISTENCY ed è forzato dal rm predefinito nel volume di sistema. |
LoggingMode
Modalità di registrazione corrente.
| Valore | Significato |
|---|---|
|
Viene usata la registrazione semplice. |
|
Viene usata la registrazione completa |
Reserved
Riservato.
RmState
Stato del RM. I valori validi sono i seguenti.
LogCapacity
Capacità totale del log, in byte.
LogFree
Numero di byte gratuiti nel log.
TopsSize
Dimensioni del file $Tops, in byte.
TopsUsed
Quantità del file $Tops in uso, in byte.
TransactionCount
Numero di transazioni attive, al momento dell'emissione della query.
OnePCCount
Numero di operazioni di commit a più fasi che si sono verificate in questo RM.
TwoPCCount
Numero di operazioni di commit a due fasi che si sono verificate in questo RM.
NumberLogFileFull
Numero di volte in cui il log di RM è diventato pieno.
OldestTransactionAge
Lunghezza della transazione attiva meno recente, in millisecondi.
RMName
GUID che indica il nome di questo RM.
TmLogPathOffset
Offset dall'inizio di questa struttura a una stringa Unicode con terminazione NULL contenente il percorso del log di TM.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Intestazione | winioctl.h (include Windows.h) |