FILE_ID_GLOBAL_TX_DIR_INFORMATION-Struktur (ntifs.h)
Die FILE_ID_GLOBAL_TX_DIR_INFORMATION-Struktur enthält Informationen zur Transaktionstransaktionssicht für die Dateien in einem Verzeichnis.
Syntax
typedef struct _FILE_ID_GLOBAL_TX_DIR_INFORMATION {
ULONG NextEntryOffset;
ULONG FileIndex;
LARGE_INTEGER CreationTime;
LARGE_INTEGER LastAccessTime;
LARGE_INTEGER LastWriteTime;
LARGE_INTEGER ChangeTime;
LARGE_INTEGER EndOfFile;
LARGE_INTEGER AllocationSize;
ULONG FileAttributes;
ULONG FileNameLength;
LARGE_INTEGER FileId;
GUID LockingTransactionId;
ULONG TxInfoFlags;
WCHAR FileName[1];
} FILE_ID_GLOBAL_TX_DIR_INFORMATION, *PFILE_ID_GLOBAL_TX_DIR_INFORMATION;
Member
NextEntryOffset
Der Byteoffset vom Anfang dieses Eintrags, an dem sich der nächste FILE_ID_FULL_DIR_INFORMATION Eintrag befindet, wenn mehrere Einträge in einem Puffer vorhanden sind. Ein Wert von 0 gibt an, dass keine anderen Einträge diesem Folgen folgen.
FileIndex
Der Byteoffset der Datei im übergeordneten Verzeichnis. Für Dateisysteme, in denen die Position einer Datei im übergeordneten Verzeichnis nicht festgelegt ist und geändert werden kann, um die Sortierreihenfolge beizubehalten, sollte dieses Feld auf 0 festgelegt und ignoriert werden.
CreationTime
Der Zeitpunkt, zu dem die Datei erstellt wurde.
LastAccessTime
Der letzte Zugriff auf die Datei.
LastWriteTime
Das letzte Mal, wenn Informationen in die Datei geschrieben wurden.
ChangeTime
Der Zeitpunkt, zu dem die Datei zuletzt geändert wurde.
EndOfFile
Die absolute neue Position am Ende der Datei als Byteoffset vom Anfang der Datei. EndOfFile gibt den Offset auf das Byte direkt nach dem letzten gültigen Byte in der Datei an.
AllocationSize
Die Dateizuordnungsgröße in Bytes. Der Wert dieses Felds ist ein ganzzahliges Vielfaches der Clustergröße.
FileAttributes
Die Dateiattribute.
| Flag | Bedeutung |
|---|---|
| FILE_ATTRIBUTE_NORMAL | Eine Datei mit Standardattributen sollte erstellt werden. |
| FILE_ATTRIBUTE_READONLY | Es sollte eine schreibgeschützte Datei erstellt werden. |
| FILE_ATTRIBUTE_HIDDEN | Es sollte eine ausgeblendete Datei erstellt werden. |
| FILE_ATTRIBUTE_SYSTEM | Es sollte eine Systemdatei erstellt werden. |
| FILE_ATTRIBUTE_ARCHIVE | Die Datei sollte so markiert werden, dass sie archiviert wird. |
| FILE_ATTRIBUTE_TEMPORARY | Es sollte eine temporäre Datei erstellt werden. |
FileNameLength
Die Länge des Dateinamens in Bytes, der im FileName-Element enthalten ist.
FileId
Eine Dateireferenznummer für die Datei. Das Dateisystem generiert diese Nummer und weist sie der Datei zu. Für Dateisysteme, die FileId nicht unterstützen, wird dieses Feld auf 0 festgelegt und ignoriert.
LockingTransactionId
Ein GUID-Wert der Transaktion, für die diese Datei zur Änderung gesperrt ist. Diesen Wert wird vom Dateisystem generiert und zugewiesen.
TxInfoFlags
Ein bitweiser OR mit 0 oder mehr der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED 0x00000001 | Die Datei ist für änderungen durch eine Transaktion gesperrt. Die ID der Transaktion muss im Member LockingTransactionId enthalten sein, wenn dieses Flag festgelegt ist. |
| FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_TO_TX 0x00000002 | Die Datei ist für Transaktionsumeratoren des Verzeichnisses sichtbar, dessen Transaktions-ID sich im LockingTransactionId-Element befindet. |
| FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_OUTSIDE_TX 0x00000004 | Die Datei ist für transaktionsbasierte Enumeratoren des anderen Verzeichnisses als das Verzeichnis sichtbar, dessen Transaktions-ID sich im LockingTransactionId-Member befindet, und sie ist für nicht transaktionierte Enumeratoren des Verzeichnisses sichtbar. |
Wenn das FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED-Flag nicht festgelegt ist, dürfen die anderen Flags nicht festgelegt werden. Wenn andere Flags als FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED festgelegt werden, muss das FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED-Flag festgelegt werden.
FileName[1]
Eine Sequenz von Unicode-Zeichen, die den Dateinamen enthalten.
Hinweise
Die FILE_ID_GLOBAL_TX_DIR_INFORMATION-Struktur kann für Dateisysteme implementiert werden, die das FILE_SUPPORTS_TRANSACTIONS-Flag als Reaktion auf eine Abfrage mithilfe einer FILE_FS_ATTRIBUTE_INFORMATION-Struktur zurückgeben. Es darf nicht für Dateisysteme implementiert werden, die dieses Flag nicht zurückgeben.
Wenn das FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED-Flag in TxInfoFlags nicht festgelegt ist, wird LockingTransactionId ignoriert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 |
| Kopfzeile | ntifs.h (include FltKernel.h, Ntifs.h) |