struttura TXFS_GET_TRANSACTED_VERSION (winioctl.h)

Articolo
03/04/2024

[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 sulla base e sulle versioni più recenti del file specificato.

Sintassi

typedef struct _TXFS_GET_TRANSACTED_VERSION {
  DWORD ThisBaseVersion;
  DWORD LatestVersion;
  WORD  ThisMiniVersion;
  WORD  FirstMiniVersion;
  WORD  LatestMiniVersion;
} TXFS_GET_TRANSACTED_VERSION, *PTXFS_GET_TRANSACTED_VERSION;

Members

ThisBaseVersion

Versione del file con cui viene aperto l'handle. Questo membro può essere uno dei valori seguenti.

Valore	Significato
TXFS_TRANSACTED_VERSION_NONTRANSACTED 0xFFFFFFFE	Il file non è un file transazionato.
TXFS_TRANSACTED_VERSION_UNCOMMITTED 0xffffffff	Il file è stato aperto come writer transazionato.

Se l'handle è stato aperto come lettore transazionale, il valore restituito per questo membro è un numero intero positivo che rappresenta il numero di versione del file a cui è associato l'handle.

LatestVersion

Versione di cui è stato eseguito il commit più recente del file.

ThisMiniVersion

Se l'handle di un miniversione è aperto, questo membro contiene l'ID della miniversione. Se l'handle non è aperto, questo membro è zero (0).

FirstMiniVersion

La prima miniversione disponibile per questo file. Se non sono presenti miniversioni o non sono visibili alla transazione associata all'handle di file, questo campo è zero (0).

LatestMiniVersion

Miniversione disponibile più recente per questo file. Se non sono presenti miniversioni o non sono visibili alla transazione associata all'handle di file, questo campo è zero (0).

Commenti

Il numero di versione di base rimane invariato per la durata di un handle. Il numero di versione più recente aumenta finché un handle è ancora aperto a un file e viene eseguito il commit di una modifica. Quando l'handle viene chiuso, il numero di versione viene reimpostato su zero.

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)

Vedi anche

FSCTL_TXFS_GET_TRANSACTED_VERSION

Condividi tramite