struttura TXFS_MODIFY_RM (winioctl.h)
[Microsoft consiglia vivamente agli sviluppatori di usare mezzi alternativi per soddisfare le esigenze dell'applicazione. Molti scenari per cui è stato sviluppato TxF possono essere ottenuti tramite tecniche più semplici e più facilmente disponibili. 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 le informazioni necessarie quando si modificano i parametri di log e la modalità di registrazione per un gestore risorse secondario.
Sintassi
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
Parametri di log da impostare.
Questo membro può essere uno o più dei valori seguenti.
| Valore | Significato |
|---|---|
|
Se questo flag è impostato, viene utilizzato il membro LoggingMode di questa struttura. Se il flag non è impostato, il membro LoggingMode viene ignorato. |
|
Se questo flag è impostato, viene richiesto all'RM di rinominarsi (creando un nuovo GUID). |
|
Se questo flag è impostato, viene usato il membro LogContainerCountMax . Se il flag non è impostato, il membro LogContainerCountMax viene ignorato. Questo flag si escludono a vicenda con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Se questo flag è impostato, viene utilizzato il membro LogContainerCountMin . Se il flag non è impostato, il membro LogContainerCountMin viene ignorato. Questo flag si escludono a vicenda con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Se questo flag è impostato, viene utilizzato il membro LogGrowthIncrement . Se il flag non è impostato, il membro LogGrowthIncrement viene ignorato. Questo flag indica che il log deve aumentare del numero di contenitori specificati nel membro LogGrowthIncrement . Questo flag si escludono a vicenda con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_PERCENT. |
|
Se questo flag è impostato, viene utilizzato il membro LogGrowthIncrement . Se il flag non è impostato, il membro LogGrowthIncrement viene ignorato. Questo flag indica che il log deve aumentare della percentuale delle dimensioni del log specificate nel membro LogGrowthIncrement . Questo flag si escludono a vicenda con TXFS_RM_FLAG_LOG_GROWTH_INCREMENT_NUM_CONTAINERS. |
|
Se questo flag è impostato, viene utilizzato il membro LogAutoShrinkPercentage . Se il flag non è impostato, LogAutoShrinkPercentage viene ignorato. |
|
Se questo flag è impostato, viene richiesto all'RM di consentire l'aumento del log senza limiti. Questo flag si escludono a vicenda con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MIN. |
|
Se questo flag è impostato, l'RM viene richiesto di consentire al log di compattare il log a soli due contenitori. Questo flag si escludono a vicenda con TXFS_RM_FLAG_LOG_NO_CONTAINER_COUNT_MAX. |
|
Se questo flag è impostato, viene richiesto al log di aumentare immediatamente le dimensioni specificate in LogContainerCount. Se il flag non è impostato, LogContainerCount viene ignorato. |
|
Se questo flag è impostato, il log viene indicato di ridurne immediatamente le dimensioni alle dimensioni specificate in LogContainerCount. Se questo flag e TXFS_RM_FLAG_ENFORCE_MINIMUM_SIZE sono impostati, il log viene richiesto di ridurne le dimensioni minime consentite e LogContainerCount viene ignorato. |
|
Se questo flag e TXFS_RM_FLAG_SHRINK_LOG sono impostati, il log viene richiesto di ridurne le dimensioni minime consentite e LogContainerCount viene ignorato. Se questo flag è impostato, è necessario impostare il TXFS_RM_FLAG_SHRINK_LOG . |
|
Se questo flag è impostato, viene richiesto al log di mantenere le modifiche sul disco. Se questo flag non è impostato, le modifiche apportate sono temporanee, ovvero fino a quando l'RM non viene arrestato e riavviato. |
|
Questo flag è valido solo per le macchine virtuali predefinite, non per le macchine virtuali secondarie. Se questo flag è impostato, l'RM viene richiesto di reimpostare se stesso alla successiva avvio. Il log e i metadati associati vengono eliminati. |
|
Questo flag è valido solo per le macchine virtuali predefinite, non per le macchine virtuali secondarie. Se questo flag è impostato, una chiamata precedente a FSCTL_TXFS_MODIFY_RM viene annullata con il flag TXFS_RM_FLAG_RESET_RM_AT_NEXT_START impostato. |
|
Indica che l'RM deve preferire la coerenza delle transazioni rispetto alla disponibilità del sistema. Questo flag si escludono a vicenda con TXFS_RM_FLAG_PREFER_AVAILABILITY e non è supportato dall'RM predefinito nel volume di sistema. |
|
Indica che rm è quello di preferire la disponibilità del sistema rispetto alla coerenza delle transazioni. Questo flag si escludono a vicenda con TXFS_RM_FLAG_PREFER_CONSISTENCY ed è forzato dall'RM predefinito nel volume di sistema. |
LogContainerCountMax
Dimensioni massime del log, in contenitori.
LogContainerCountMin
Dimensioni minime del log, nei contenitori.
LogContainerCount
Dimensioni effettive del log, nei contenitori.
LogGrowthIncrement
Numero di contenitori o percentuale di spazio da aggiungere al log.
LogAutoShrinkPercentage
Percentuale di spazio di log da mantenere libera. Questo membro viene usato quando viene usato il flag TXFS_RM_FLAG_LOG_AUTO_SHRINK_PERCENTAGE e indica al log di compattarsi automaticamente, quindi non più di LogAutoShrinkPercentage del log è gratuito in qualsiasi momento.
Reserved
Riservato.
LoggingMode
Modalità di registrazione corrente.
| Valore | Significato |
|---|---|
|
Viene usata la registrazione semplice. |
|
Viene usata la registrazione completa |
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) |