struktur FILE_ID_GLOBAL_TX_DIR_INFORMATION (ntifs.h)

Struktur FILE_ID_GLOBAL_TX_DIR_INFORMATION berisi informasi tentang visibilitas transaksi untuk file dalam direktori.

Sintaks

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;

Anggota

NextEntryOffset

Offset byte dari awal entri ini, di mana entri FILE_ID_FULL_DIR_INFORMATION berikutnya berada jika beberapa entri ada dalam buffer. Nilai nol menunjukkan tidak ada entri lain yang mengikuti yang satu ini.

FileIndex

Offset byte file dalam direktori induk. Untuk sistem file di mana posisi file dalam direktori induk tidak diperbaiki dan dapat diubah untuk mempertahankan urutan pengurutan, bidang ini harus diatur ke 0 dan diabaikan.

CreationTime

Waktu ketika file dibuat.

LastAccessTime

Terakhir kali file diakses.

LastWriteTime

Terakhir kali informasi ditulis ke file.

ChangeTime

Terakhir kali file diubah.

EndOfFile

Posisi akhir file baru absolut sebagai offset byte dari awal file. EndOfFile menentukan offset ke byte segera setelah byte terakhir yang valid dalam file.

AllocationSize

Ukuran alokasi file dalam byte. Nilai bidang ini adalah kelipatan bilangan bulat dari ukuran kluster.

FileAttributes

Atribut file.

Bendera	Makna
FILE_ATTRIBUTE_NORMAL	File yang memiliki atribut standar harus dibuat.
FILE_ATTRIBUTE_READONLY	File baca-saja harus dibuat.
FILE_ATTRIBUTE_HIDDEN	File tersembunyi harus dibuat.
FILE_ATTRIBUTE_SYSTEM	File sistem harus dibuat.
FILE_ATTRIBUTE_ARCHIVE	File harus ditandai sehingga akan diarsipkan.
FILE_ATTRIBUTE_TEMPORARY	File sementara harus dibuat.

FileNameLength

Panjang, dalam byte, dari nama file yang terkandung dalam anggota FileName .

FileId

Nomor referensi file untuk file. Sistem file menghasilkan angka ini dan menetapkannya ke file. Untuk sistem file yang tidak mendukung FileId, bidang ini diatur ke 0 dan diabaikan.

LockingTransactionId

Nilai GUID transaksi yang memiliki file ini terkunci untuk modifikasi. Sistem file menghasilkan dan menetapkan nilai ini.

TxInfoFlags

Bitwise OR nol atau lebih dari nilai berikut.

Nilai	Makna
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED 0x00000001	File dikunci untuk modifikasi oleh transaksi. ID transaksi harus terkandung dalam anggota LockingTransactionId jika bendera ini diatur.
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_TO_TX 0x00000002	File terlihat oleh enumerator direktori yang ditransaksikan yang ID transaksinya ada di anggota LockingTransactionId .
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_OUTSIDE_TX 0x00000004	File terlihat oleh enumerator direktori yang ditransaksikan selain yang ID transaksinya ada di anggota LockingTransactionId , dan terlihat oleh enumerator direktori yang tidak ditransaksikan.

 

Jika bendera FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED tidak diatur, bendera lain tidak boleh diatur. Jika bendera selain FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED diatur, bendera FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED harus diatur.

FileName[1]

Urutan karakter Unicode yang berisi nama file.

Catatan Gunakan FileNameLength untuk menentukan panjang nama file daripada mengasumsikan keberadaan pemisah null berikutnya.

 

Keterangan

Struktur FILE_ID_GLOBAL_TX_DIR_INFORMATION dapat diimplementasikan untuk sistem file yang mengembalikan bendera FILE_SUPPORTS_TRANSACTIONS sebagai respons terhadap kueri menggunakan struktur FILE_FS_ATTRIBUTE_INFORMATION . Ini tidak boleh diimplementasikan untuk sistem file yang tidak mengembalikan bendera tersebut.

Jika bendera FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED tidak diatur di TxInfoFlags, LockingTransactionId diabaikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Header	ntifs.h (termasuk FltKernel.h, Ntifs.h)