GetFileAttributesW 函式（fileapi.h）

發行項
11/20/2024

擷取指定檔案或目錄的檔案系統屬性。

若要取得更多屬性資訊，請使用 GetFileAttributesEx 函式。

若要以交易作業的形式執行此作業，請使用 GetFileAttributesTransacted 函式。

語法

DWORD GetFileAttributesW(
  [in] LPCWSTR lpFileName
);

參數

[in] lpFileName

檔案或目錄的名稱。

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

提示

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

傳回值

如果函式成功，傳回值會包含指定檔案或目錄的屬性。如需屬性值及其描述的清單，請參閱檔案屬性常數。

如果函式失敗，傳回值會 INVALID_FILE_ATTRIBUTES。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

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

如果您針對網路分享呼叫 GetFileAttributes，函式會失敗，GetLastError 會傳回 ERROR_BAD_NETPATH。您必須指定該共享上子資料夾的路徑。

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

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

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

交易作業

如果檔案已開啟以在交易中修改，則除非認可交易，否則沒有其他線程可以開啟檔案以進行修改。因此，如果交易線程先開啟檔案，則任何後續嘗試在認可交易之前修改檔案的線程會收到共享違規。如果非交易線程在交易線程之前修改檔案，而且當交易嘗試開啟檔案時，檔案仍會開啟，則交易會收到錯誤 ERROR_TRANSACTIONAL_CONFLICT。

例子

如需範例，請參閱擷取和變更檔案屬性。

注意

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

要求

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