GetFileAttributesTransactedW 函式（winbase.h）

發行項
11/20/2024

[Microsoft強烈建議開發人員利用替代方法來達成應用程式的需求。 TxF 開發的許多案例都可以透過更簡單且更容易使用的技術來達成。此外，未來版本的 Microsoft Windows 可能無法使用 TxF。如需詳細資訊和 TxF 的替代方案，請參閱使用交易式 NTFS的替代專案。

擷取指定檔案或目錄的檔案系統屬性做為交易作業。

語法

BOOL GetFileAttributesTransactedW(
  [in]  LPCWSTR                lpFileName,
  [in]  GET_FILEEX_INFO_LEVELS fInfoLevelId,
  [out] LPVOID                 lpFileInformation,
  [in]  HANDLE                 hTransaction
);

參數

[in] lpFileName

檔案或目錄的名稱。

檔案或目錄必須位於本機計算機上;否則，函式會失敗，且最後一個錯誤碼會設定為 ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE。

根據預設，名稱限製為MAX_PATH個字元。若要將此限制延伸至 32,767 寬字元，請在路徑前面加上 “\\？\”。如需詳細資訊，請參閱命名檔案、路徑和命名空間。

提示

從 Windows 10 版本 1607 開始，您可以選擇移除MAX_PATH限制，而不需預先加上 “\\？\”。如需詳細資訊，請參閱命名檔案、路徑和命名空間的一節。

[in] fInfoLevelId

要擷取的屬性資訊層級。

這個參數可以是來自 GET_FILEEX_INFO_LEVELS 列舉的下列值。

價值	意義
GetFileExInfoStandard	lpFileInformation 參數是 WIN32_FILE_ATTRIBUTE_DATA 結構。

[out] lpFileInformation

接收屬性信息的緩衝區指標。

儲存至此緩衝區的屬性資訊類型取決於 fInfoLevelId的值。如果 fInfoLevelId 參數 GetFileExInfoStandard，則此參數會指向 WIN32_FILE_ATTRIBUTE_DATA 結構

[in] hTransaction

交易的句柄。此句柄是由 createTransaction 函式傳回。

傳回值

如果函式成功，則傳回值為非零值。

如果函式失敗，傳回值為零（0）。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

GetFileAttributesTransacted 在掛接資料夾的目錄上呼叫時，它會傳回目錄的屬性，而不是掛接資料夾與目錄關聯之磁碟區中根目錄的屬性。若要取得相關聯磁碟區的檔案屬性，請呼叫 GetVolumeNameForVolumeMountPoint 以取得相關聯磁碟區的名稱。然後在呼叫 GetFileAttributesTransacted中使用產生的名稱。結果是相關聯磁碟區上根目錄的屬性。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此功能。

科技	支援
伺服器消息塊（SMB） 3.0 通訊協定	不
SMB 3.0 透明故障轉移（TFO）	不
具有向外延展檔案共用的SMB 3.0（SO）	不
叢集共用磁碟區檔案系統（CsvFS）	不
復原檔案系統（ReFS）	不

SMB 3.0 不支援 TxF。

符號連結：如果路徑指向符號連結，函式會傳回符號連結的屬性。

交易作業

如果檔案已開啟以在交易中修改，則除非認可交易，否則沒有其他線程可以開啟檔案以進行修改。相反地，如果檔案在異動之外進行修改，則任何交易線程都無法開啟檔案進行修改，直到非交易句柄關閉為止。如果非交易線程已開啟句柄以修改檔案，則呼叫 GetFileAttributesTransacted 檔案將會失敗，並出現 ERROR_TRANSACTIONAL_CONFLICT 錯誤。

注意

winbase.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetFileAttributesTransacted 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求

要求	價值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	winbase.h （包括 Windows.h）
連結庫	Kernel32.lib
DLL	Kernel32.dll