GetFileAttributesExA 函式 (fileapi.h)
擷取指定檔案或目錄的屬性。
若要以交易作業的形式執行此作業，請使用 GetFileAttributesTransacted 函式 。
語法
BOOL GetFileAttributesExA(
[in] LPCSTR lpFileName,
[in] GET_FILEEX_INFO_LEVELS fInfoLevelId,
[out] LPVOID lpFileInformation
);
參數
[in] lpFileName
檔案或目錄的名稱。
根據預設，名稱限制為MAX_PATH個字元。 若要將此限制延伸至 32，767 寬字元，請在路徑前面加上 「\\？\」。 如需詳細資訊，請參閱命名檔案、路徑與命名空間。
提示
從 Windows 10 版本 1607 開始，您可以選擇移除MAX_PATH限制，而不需在前面加上 「\\？\」。 如需詳細資訊，請參閱 命名檔案、路徑和命名空間 的一節。
[in] fInfoLevelId
要擷取的屬性資訊類別。
此參數可以是 來自GET_FILEEX_INFO_LEVELS 列舉的下列值。
| 值 | 意義 |
|---|---|
|
lpFileInformation參數是WIN32_FILE_ATTRIBUTE_DATA結構。 |
[out] lpFileInformation
接收屬性資訊的緩衝區指標。
儲存到這個緩衝區的屬性資訊類型取決於 fInfoLevelId的值。
傳回值
如果函式成功，則傳回值是非零值。
如果函式失敗，傳回值會是零 (0) 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
GetFileAttributes 函式會擷取檔案系統屬性資訊。 GetFileAttributesEx 可以取得其他一組檔案或目錄屬性資訊。 目前， GetFileAttributesEx 會擷取一組標準屬性，這是檔案系統屬性資訊的超集合。
當 GetFileAttributesEx 函式在掛接的資料夾上呼叫時，它會傳回目錄的屬性，而不是掛接資料夾與目錄相關聯之磁片區中根目錄的屬性。 若要取得相關聯磁片區的屬性，請呼叫 GetVolumeNameForVolumeMountPoint 以取得相關聯磁片區的名稱。 然後在 GetFileAttributesEx的呼叫中使用產生的名稱。 結果為相關聯磁片區上根目錄的屬性。
在Windows 8和Windows Server 2012中，下列技術支援此函式。
| 技術 | 支援 |
|---|---|
| 伺服器訊息區 (SMB) 3.0 通訊協定 | Yes |
| SMB 3.0 透明容錯移轉 (TFO) | Yes |
| 具有向外延展檔案共用的 SMB 3.0 (SO) | Yes |
| 叢集共用磁片區檔案系統 (CsvFS) | Yes |
| 彈性檔案系統 (ReFS) | Yes |
符號連結行為： 如果路徑指向符號連結，函式會傳回符號連結的屬性。
交易作業
如果檔案已開啟以在交易中修改，則除非認可交易，否則沒有其他執行緒可以開啟檔案以進行修改。 因此，如果交易執行緒先開啟檔案，則任何後續嘗試在認可交易之前修改檔案的執行緒會收到共用違規。 如果非交易執行緒在交易執行緒之前修改檔案，而且當交易嘗試開啟檔案時，檔案仍會開啟，交易會收到錯誤 ERROR_TRANSACTIONAL_CONFLICT。注意
fileapi.h 標頭會根據 UNICODE 預處理器常數的定義，將 GetFileAttributesEx 定義為別名，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼，可能會導致編譯或執行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | fileapi.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |