fileapi.h 標頭

此標頭由多個技術使用。 如需詳細資訊，請參閱：

• 資料存取和記憶體
• System Services

fileapi.h 包含下列程序設計介面：

功能

AreFileApisANSI 判斷檔案 I/O 函式是否使用 ANSI 或 OEM 字元集代碼頁。
AreShortNamesEnabled AreShortNamesEnabled 函式會判斷指定的磁碟區是否啟用簡短名稱。
CompareFileTime 比較兩個檔案時間。
CreateDirectory2A 建立新目錄。 （ANSI）
CreateDirectory2W 建立新目錄。 （Unicode）
CreateDirectoryA 建立新目錄。 （CreateDirectoryA）
CreateDirectoryW 建立新目錄。 （CreateDirectoryW）
CreateFile2 建立或開啟檔案或 I/O 裝置。
CreateFile3 建立或開啟檔案或 I/O 裝置。
CreateFileA 建立或開啟檔案或 I/O 裝置。 最常使用的 I/O 裝置如下：_file、檔案數據流、目錄、實體磁碟、磁碟區、控制台緩衝區、磁帶機、通訊資源、mailslot 和管道。 （ANSI）
CreateFileW 建立或開啟檔案或 I/O 裝置。 最常使用的 I/O 裝置如下：_file、檔案數據流、目錄、實體磁碟、磁碟區、控制台緩衝區、磁帶機、通訊資源、mailslot 和管道。 （Unicode）
DefineDosDeviceW 定義、重新定義或刪除 MS-DOS 裝置名稱。 （DefineDosDeviceW）
DeleteFile2A 刪除現有的檔案。 （ANSI）
DeleteFile2W 刪除現有的檔案。 （Unicode）
DeleteFileA 刪除現有的檔案。 （DeleteFileA）
DeleteFileW 刪除現有的檔案。 （DeleteFileW）
DeleteVolumeMountPointW 刪除驅動器號或掛接的資料夾。 （DeleteVolumeMountPointW）
FileTimeToLocalFileTime 將檔案時間轉換為本機檔案時間。
FindClose 關閉 FindFirstFile、FindFirstFileEx、FindFirstFileNameW、FindFirstFileNameTransactedW、FindFirstFileTransactedW、FindFirstStreamTransactedW 或 FindFirstStreamW 函式開啟的檔案搜尋句柄。
FindCloseChangeNotification 停止變更通知句柄監視。
FindFirstChangeNotificationA 建立變更通知句柄，並設定初始變更通知篩選條件。 （ANSI）
FindFirstChangeNotificationW 建立變更通知句柄，並設定初始變更通知篩選條件。 （Unicode）
FindFirstFileA 使用符合特定名稱的名稱來搜尋檔案或子目錄（如果使用通配符則為部分名稱）。 （ANSI）
FindFirstFileExA 使用符合指定名稱與屬性的檔案或子目錄搜尋目錄。 （FindFirstFileExA）
FindFirstFileExW 使用符合指定名稱與屬性的檔案或子目錄搜尋目錄。 （FindFirstFileExW）
FindFirstFileNameW 建立指定檔案之所有硬式連結的列舉。 FindFirstFileNameW 函式會傳回列舉的句柄，此句柄可用於 FindNextFileNameW 函式的後續呼叫。
FindFirstFileW 使用符合特定名稱的名稱來搜尋檔案或子目錄（如果使用通配符則為部分名稱）。 （Unicode）
FindFirstStreamW 列舉指定檔案或目錄中具有 ：：$DATA 數據流類型的第一個數據流。
FindFirstVolumeW 擷取電腦上的磁碟區名稱。 （FindFirstVolumeW）
FindNextChangeNotification 要求作系統在下次偵測到適當的變更時發出變更通知的訊號。
FindNextFileA 繼續從先前呼叫 FindFirstFile、FindFirstFileEx 或 FindFirstFileTransacted 函式的檔案搜尋。 （ANSI）
FindNextFileNameW 使用成功呼叫 FindFirstFileNameW 函式所傳回的句柄，繼續列舉檔案的硬式連結。
FindNextFileW 繼續從先前呼叫 FindFirstFile、FindFirstFileEx 或 FindFirstFileTransacted 函式的檔案搜尋。 （Unicode）
FindNextStreamW 繼續先前呼叫 FindFirstStreamW 函式所啟動的串流搜尋。
FindNextVolumeW 繼續呼叫 FindFirstVolume 函式所啟動的磁碟區搜尋。 （FindNextVolumeW）
FindVolumeClose 關閉指定的磁碟區搜尋句柄。
FlushFileBuffers 清除指定檔案的緩衝區，並導致所有緩衝的數據寫入檔案。
GetCompressedFileSizeA 擷取用來儲存指定檔案的實際磁碟記憶體位元組數目。 （ANSI）
GetCompressedFileSizeW 擷取用來儲存指定檔案的實際磁碟記憶體位元組數目。 （Unicode）
GetDiskFreeSpaceA 擷取指定磁碟的相關信息，包括磁碟上的可用空間量。 （ANSI）
GetDiskFreeSpaceExA 擷取磁碟區上可用空間量的相關信息，也就是總空間量、可用空間總量，以及與呼叫線程相關聯的使用者可用的可用空間總量。 （ANSI）
GetDiskFreeSpaceExW 擷取磁碟區上可用空間量的相關信息，也就是總空間量、可用空間總量，以及與呼叫線程相關聯的使用者可用的可用空間總量。 （Unicode）
GetDiskFreeSpaceW 擷取指定磁碟的相關信息，包括磁碟上的可用空間量。 （Unicode）
GetDiskSpaceInformationA 取得位於指定根路徑之磁碟區的磁碟空間資訊。
GetDiskSpaceInformationW 取得位於指定根路徑之磁碟區的磁碟空間資訊。
GetDriveTypeA 判斷磁碟驅動器是否為卸載式、固定、CD-ROM、RAM 磁碟或網路驅動器機。 （ANSI）
GetDriveTypeW 判斷磁碟驅動器是否為卸載式、固定、CD-ROM、RAM 磁碟或網路驅動器機。 （Unicode）
GetFileAttributesA 擷取指定檔案或目錄的檔案系統屬性。 （ANSI）
GetFileAttributesExA 擷取指定檔案或目錄的屬性。 （ANSI）
GetFileAttributesExW 擷取指定檔案或目錄的屬性。 （Unicode）
GetFileAttributesW 擷取指定檔案或目錄的檔案系統屬性。 （Unicode）
GetFileInformationByHandle 擷取指定檔案的檔案資訊。 （GetFileInformationByHandle）
GetFileSize 擷取指定檔案的大小，以位元組為單位。
GetFileSizeEx 擷取指定檔案的大小。
GetFileTime 擷取檔案或目錄建立、上次存取和上次修改的日期和時間。
GetFileType 擷取指定檔案的檔類型。
GetFinalPathNameByHandleA 擷取指定檔案的最終路徑。 （ANSI）
GetFinalPathNameByHandleW 擷取指定檔案的最終路徑。 （Unicode）
GetFullPathNameA 擷取指定檔案的完整路徑和檔名。 （ANSI）
GetFullPathNameW 擷取指定檔案的完整路徑和檔名。 （Unicode）
GetLogicalDrives 擷取代表目前可用磁碟驅動器的位掩碼。
GetLogicalDriveStringsW 以指定系統中有效磁碟驅動器的字串填入緩衝區。 （GetLogicalDriveStringsW）
GetLongPathNameA 將指定的路徑轉換成其長格式。 （ANSI）
GetLongPathNameW 將指定的路徑轉換成其長格式。 （Unicode）
GetShortPathNameW 擷取指定路徑的簡短路徑形式。 （GetShortPathNameW）
GetTempFileNameA 建立暫存盤的名稱。 如果產生唯一的檔名，則會建立空的檔案，並釋放它的句柄;否則，只會產生檔名。 （GetTempFileNameA）
GetTempFileNameW 建立暫存盤的名稱。 如果產生唯一的檔名，則會建立空的檔案，並釋放它的句柄;否則，只會產生檔名。 （GetTempFileNameW）
GetTempPath2A 根據呼叫程式的許可權，擷取針對暫存盤指定的目錄路徑。 （ANSI）
GetTempPath2W 根據呼叫程式的許可權，擷取針對暫存盤指定的目錄路徑。 （Unicode）
GetTempPathA 擷取針對暫存盤指定之目錄的路徑。 （ANSI）
GetTempPathW 擷取針對暫存盤指定之目錄的路徑。 （Unicode）
GetVolumeInformationA 擷取與指定根目錄相關聯的文件系統和磁碟區相關信息。 （ANSI）
GetVolumeInformationByHandleW 擷取與指定檔案相關聯的文件系統和磁碟區相關信息。
GetVolumeInformationW 擷取與指定根目錄相關聯的文件系統和磁碟區相關信息。 （Unicode）
GetVolumeNameForVolumeMountPointW 擷取與指定磁碟區裝入點相關聯的磁碟區 GUID 路徑（驅動器號、磁碟區 GUID 路徑或掛接資料夾）。 （GetVolumeNameForVolumeMountPointW）
GetVolumePathNamesForVolumeNameW 擷取指定磁碟區驅動器號和掛接的資料夾路徑清單。 （GetVolumePathNamesForVolumeNameW）
GetVolumePathNameW 擷取掛接指定路徑的磁碟區裝入點。 （GetVolumePathNameW）
LocalFileTimeToFileTime 根據國際標準時間（UTC）將本機檔案時間轉換為檔案時間。
LockFile 藉由呼叫進程鎖定指定的檔案進行獨佔存取。
LockFileEx 藉由呼叫進程鎖定指定的檔案進行獨佔存取。 此函式可以同步或異步作，而且可以要求獨佔或共享鎖定。
QueryDosDeviceW 擷取 MS-DOS 裝置名稱的相關信息。 （QueryDosDeviceW）
ReadFile 從指定的檔案或輸入/輸出 （I/O） 裝置讀取數據。 如果裝置支援，讀取會發生在檔案指標所指定的位置。
ReadFileEx 從指定的檔案或輸入/輸出 （I/O） 裝置讀取數據。 它會以異步方式報告其完成狀態，在讀取完成或取消時呼叫指定的完成例程，且呼叫線程處於可警示的等候狀態。
ReadFileScatter 從檔案讀取數據，並將其儲存在緩衝區陣列中。
RemoveDirectory2A 刪除現有的空白目錄。 （ANSI）
RemoveDirectory2W 刪除現有的空白目錄。 （Unicode）
RemoveDirectoryA 刪除現有的空白目錄。 （ANSI）
RemoveDirectoryW 刪除現有的空白目錄。 （Unicode）
SetEndOfFile 將指定檔案的實體檔案大小設定為檔案指標的目前位置。
SetFileApisToANSI 讓檔案 I/O 函式使用目前進程的 ANSI 字元集代碼頁。
SetFileApisToOEM 讓進程的檔案 I/O 函式使用 OEM 字元集代碼頁。
SetFileAttributesA 設定檔案或目錄的屬性。 （ANSI）
SetFileAttributesW 設定檔案或目錄的屬性。 （Unicode）
SetFileInformationByHandle 設定指定檔案的檔案資訊。
SetFileIoOverlappedRange 將虛擬位址範圍與指定的檔句柄產生關聯。
SetFilePointer 移動指定檔案的檔案指標。 （SetFilePointer）
SetFilePointerEx 移動指定檔案的檔案指標。 （SetFilePointerEx）
SetFileTime 設定指定的檔案或目錄建立、上次存取或修改的日期和時間。
SetFileValidData 設定指定檔案的有效數據長度。 此函式在非常有限的案例中很有用。 如需詳細資訊，請參閱一節。
UnlockFile 解除鎖定開啟檔案中的區域。
UnlockFileEx 解除鎖定指定檔案中的區域。 此函式可以同步或異步作。
WriteFile 將數據寫入指定的檔案或輸入/輸出 （I/O） 裝置。
WriteFileEx 將數據寫入指定的檔案或輸入/輸出 （I/O） 裝置。 它會以異步方式報告其完成狀態，在寫入完成或取消時呼叫指定的完成例程，且呼叫線程處於可警示的等候狀態。
WriteFileGather 從緩衝區陣列擷取數據，並將數據寫入檔案。

結構

BY_HANDLE_FILE_INFORMATION 包含 GetFileInformationByHandle 函式所擷取的資訊。
CREATEFILE2_EXTENDED_PARAMETERS 包含 CreateFile2 的選擇性擴充參數。
CREATEFILE3_EXTENDED_PARAMETERS
DISK_SPACE_INFORMATION DISK_SPACE_INFORMATION 結構包含特定磁碟區磁碟空間的相關信息。
WIN32_FILE_ATTRIBUTE_DATA 包含檔案或目錄的屬性資訊。
WIN32_FIND_STREAM_DATA 包含 FindFirstStreamW 或 FindNextStreamW 函式所找到之數據流的相關信息。

列舉

DIRECTORY_FLAGS 定義可與 CreateDirectory2 函式搭配使用的旗標，以指定應該如何建立目錄。
STREAM_INFO_LEVELS 定義與 FindFirstStreamW 函式搭配使用的值，以指定傳回數據的資訊層級。