FILE_ID_GLOBAL_TX_DIR_INFORMATION Struktur (ntifs.h)
Die FILE_ID_GLOBAL_TX_DIR_INFORMATION-Struktur enthält Informationen zur Transaktionssichtbarkeit 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;
Angehörige
NextEntryOffset
Der Byteoffset vom Anfang dieses Eintrags, bei dem sich der nächste FILE_ID_FULL_DIR_INFORMATION Eintrag befindet, wenn mehrere Einträge in einem Puffer vorhanden sind. Ein Wert von Null gibt keine anderen Einträge an, die diesem Folgen folgen.
FileIndex
Der Byteoffset der Datei im übergeordneten Verzeichnis. Bei Dateisystemen, in denen die Position einer Datei innerhalb des übergeordneten Verzeichnisses nicht behoben 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
Das letzte Mal, wenn auf die Datei zugegriffen wurde.
LastWriteTime
Die letzten Informationen wurden in die Datei geschrieben.
ChangeTime
Das letzte Mal, wenn die Datei geändert wurde.
EndOfFile
Die absolute neue End-of-File-Position als Byte-Offset vom Anfang der Datei. EndOfFile gibt den Offset auf das Byte unmittelbar nach dem letzten gültigen Byte in der Datei an.
AllocationSize
Die Größe der Dateizuordnung in Byte. Der Wert dieses Felds ist ein ganzzahliges Vielfaches der Clustergröße.
FileAttributes
Die Dateiattribute.
| Flagge | Bedeutung |
|---|---|
| FILE_ATTRIBUTE_NORMAL | Eine Datei mit Standardattributen sollte erstellt werden. |
| FILE_ATTRIBUTE_READONLY | Eine schreibgeschützte Datei sollte erstellt werden. |
| FILE_ATTRIBUTE_HIDDEN | Eine ausgeblendete Datei sollte 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, der im FileName Member 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. Das Dateisystem generiert und weist diesen Wert zu.
TxInfoFlags
Ein bitweises ODER von null oder mehr der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED 0x00000001 | Die Datei ist für die Änderung durch eine Transaktion gesperrt. Die Transaktions-ID muss in der LockingTransactionId Member enthalten sein, wenn dieses Flag festgelegt ist. |
| FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_TO_TX 0x00000002 | Die Datei ist für Transaktionsenumeratoren des Verzeichnisses sichtbar, dessen Transaktions-ID sich im LockingTransactionId Member befindet. |
| FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_OUTSIDE_TX 0x00000004 | Die Datei ist für Transaktionsenumeratoren des anderen Verzeichnisses als deren Transaktions-ID in der LockingTransactionId Member sichtbar, und sie ist für nicht transaktionenierte 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 Kennzeichnungen als FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED festgelegt sind, muss das FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED Flag festgelegt werden.
FileName[1]
Eine Abfolge von Unicode-Zeichen, die den Dateinamen enthalten.
Bemerkungen
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. Sie 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 TxInfoFlagsnicht festgelegt ist, wird LockingTransactionId ignoriert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 7 |
| Header- | ntifs.h (include FltKernel.h, Ntifs.h) |