共用方式為

FILE_ID_GLOBAL_TX_DIR_INFORMATION結構 （ntifs.h）

  • 發行項

FILE_ID_GLOBAL_TX_DIR_INFORMATION 結構包含目錄中檔案交易可見性的相關信息。

語法

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;

成員

NextEntryOffset

這個項目開頭的位元組位移，如果緩衝區中存在多個專案，下一個FILE_ID_FULL_DIR_INFORMATION專案就會位移。 值為零表示此專案後面沒有其他專案。

FileIndex

父目錄中檔案的位元組位移。 對於父目錄內檔案位置未固定且可以變更以維持排序順序的文件系統，此欄位應設定為 0 並予以忽略。

CreationTime

檔案建立的時間。

LastAccessTime

上次存取檔案的時間。

LastWriteTime

上次將資訊寫入檔案的時間。

ChangeTime

上次變更檔案的時間。

EndOfFile

絕對新的檔尾位置，做為檔案開頭的位元組位移。 EndOfFile 會指定緊接在檔案中最後一個有效位元組之後的位元組位移。

AllocationSize

以位元組為單位的檔案配置大小。 此欄位的值是叢集大小的整數倍數。

FileAttributes

檔案屬性。

旗 意義
FILE_ATTRIBUTE_NORMAL 應該建立具有標準屬性的檔案。
FILE_ATTRIBUTE_READONLY 應該建立唯讀檔案。
FILE_ATTRIBUTE_HIDDEN 應該建立隱藏的檔案。
FILE_ATTRIBUTE_SYSTEM 應該建立系統檔案。
FILE_ATTRIBUTE_ARCHIVE 檔案應標示為封存盤。
FILE_ATTRIBUTE_TEMPORARY 應該建立暫存盤。

FileNameLength

FileName 成員中包含的檔名長度，以位元組為單位。

FileId

檔案的檔案參考編號。 文件系統會產生這個數位，並將它指派給檔案。 對於不支援 fileId 檔案系統，此字段會設定為 0 並忽略。

LockingTransactionId

已鎖定此檔案以供修改之交易的 GUID 值。 檔案系統會產生並指派此值。

TxInfoFlags

下列值的位 OR 為零或多個。

價值 意義
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED 0x00000001 檔案已鎖定以供交易修改。 如果設定此旗標，交易的標識碼必須包含在 LockingTransactionId 成員中。
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_TO_TX 0x00000002 交易標識符位於 LockingTransactionId 成員之目錄的異動列舉值可以看到檔案。
FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_VISIBLE_OUTSIDE_TX 0x00000004 除了交易標識符位於 LockingTransactionId 成員之外，目錄的異動列舉值可以看見該檔案，而且非交易列舉值對目錄的非交易列舉值可見。
 

如果未設定FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED旗標，則不得設定其他旗標。 如果已設定FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED以外的旗標，則必須設定FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED旗標。

FileName[1]

包含檔名的 Unicode 字元序列。

附注 使用 FileNameLength 來判斷檔名的長度，而不是假設有尾端的 null 分隔符。
 

言論

FILE_ID_GLOBAL_TX_DIR_INFORMATION 結構可以實作文件系統，這些文件系統會傳回FILE_SUPPORTS_TRANSACTIONS旗標，以回應使用 FILE_FS_ATTRIBUTE_INFORMATION 結構查詢。 它不得針對未傳回該旗標的文件系統實作。

如果未在 TxInfoFlags 中設定FILE_ID_GLOBAL_TX_DIR_INFO_FLAG_WRITELOCKED旗標，則會忽略 LockingTransactionId。

要求

要求 價值
最低支援的用戶端 Windows 7
標頭 ntifs.h （include FltKernel.h， Ntifs.h）