Windows File API

「Windows 有關檔案操作的 API 到底有多少個？」因為這個問題查了 MSDN 而撰寫這篇作為紀錄。

Windows 有關檔案 (file) 操作的 API 目前總共有 130 個，依序字母開頭排序如下：

1. AddUsersToEncryptedFile
2. AreFileApisANSI
3. CancelIo
4. CancelIoEx
5. CancelSynchronousIo
6. CheckNameLegalDOS8Dot3
7. CloseEncryptedFileRaw
8. CopyFile
9. CopyFile2
10. CopyFile2ProgressRoutine
11. CopyFileEx
12. CopyFileTransacted
13. CopyProgressRoutine
14. CreateFile
15. CreateFile2
16. CreateFileTransacted
17. CreateHardLink
18. CreateHardLinkTransacted
19. CreateIoCompletionPort
20. CreateSymbolicLink
21. CreateSymbolicLinkTransacted
22. DecryptFile
23. DeleteFile
24. DeleteFileTransacted
25. DuplicateEncryptionInfoFile
26. EncryptFile
27. EncryptionDisable
28. ExportCallback
29. FileEncryptionStatus
30. FileIOCompletionRoutine
31. FindClose
32. FindFirstFile
33. FindFirstFileEx
34. FindFirstFileNameTransactedW
35. FindFirstFileNameW
36. FindFirstFileTransacted
37. FindFirstStreamTransactedW
38. FindFirstStreamW
39. FindNextFile
40. FindNextFileNameW
41. FindNextStreamW
42. FlushFileBuffers
43. FreeEncryptionCertificateHashList
44. GetBinaryType
45. GetCompressedFileSize
46. GetCompressedFileSizeTransacted
47. GetExpandedName
48. GetFileAttributes
49. GetFileAttributesEx
50. GetFileAttributesTransacted
51. GetFileBandwidthReservation
52. GetFileInformationByHandle
53. GetFileInformationByHandleEx
54. GetFileSize
55. GetFileSizeEx
56. GetFileType
57. GetFinalPathNameByHandle
58. GetFullPathName
59. GetFullPathNameTransacted
60. GetLongPathName
61. GetLongPathNameTransacted
62. GetQueuedCompletionStatus
63. GetQueuedCompletionStatusEx
64. GetShortPathName
65. GetTempFileName
66. GetTempPath
67. ImportCallback
68. LockFile
69. LockFileEx
70. LZClose
71. LZCopy
72. LZInit
73. LZOpenFile
74. LZRead
75. LZSeek
76. MoveFile
77. MoveFileEx
78. MoveFileTransacted
79. MoveFileWithProgress
80. OpenEncryptedFileRaw
81. OpenFile
82. OpenFileById
83. PostQueuedCompletionStatus
84. QueryRecoveryAgentsOnEncryptedFile
85. QueryUsersOnEncryptedFile
86. ReadEncryptedFileRaw
87. ReadFile
88. ReadFileEx
89. ReadFileScatter
90. RemoveUsersFromEncryptedFile
91. ReOpenFile
92. ReplaceFile
93. SearchPath
94. SetEndOfFile
95. SetFileApisToANSI
96. SetFileApisToOEM
97. SetFileAttributes
98. SetFileAttributesTransacted
99. SetFileBandwidthReservation
100. SetFileCompletionNotificationModes
101. SetFileInformationByHandle
102. SetFileIoOverlappedRange
103. SetFilePointer
104. SetFilePointerEx
105. SetFileShortName
106. SetFileValidData
107. SetSearchPathMode
108. SetUserFileEncryptionKey
109. UnlockFile
110. UnlockFileEx
111. WofEnumEntries
112. WofEnumEntryProc
113. WofEnumFilesProc
114. WofFileEnumFiles
115. WofGetDriverVersion
116. WofIsExternalFile
117. WofSetFileDataLocation
118. WofShouldCompressBinaries
119. WofWimAddEntry
120. WofWimEnumFiles
121. WofWimRemoveEntry
122. WofWimSuspendEntry
123. WofWimUpdateEntry
124. Wow64DisableWow64FsRedirection
125. Wow64EnableWow64FsRedirection
126. Wow64RevertWow64FsRedirection
127. WriteEncryptedFileRaw
128. WriteFile
129. WriteFileEx
130. WriteFileGather

將檔案操作的 API 進行分類整理，可以分成下列幾類：

• 與檔案 I/O 有關的操作
1. CancelIo
2. CancelIoEx
3. CancelSynchronousIo
4. CheckNameLegalDOS8Dot3
5. FlushFileBuffers
6. GetQueuedCompletionStatus
7. GetQueuedCompletionStatusEx
8. LockFile
9. LockFileEx
10. PostQueuedCompletionStatus
11. ReadFile
12. ReadFileEx
13. ReadFileScatter
14. SetEndOfFile
15. SetFileCompletionNotificationModes
16. SetFileIoOverlappedRange
17. SetFilePointer
18. SetFilePointerEx
19. UnlockFile
20. UnlockFileEx
21. WriteFile
22. WriteFileEx
23. WriteFileGather
• 使用在加密的檔案系統上
1. AddUsersToEncryptedFile
2. CloseEncryptedFileRaw
3. DecryptFile
4. DuplicateEncryptionInfoFile
5. EncryptFile
6. EncryptionDisable
7. FileEncryptionStatus
8. FreeEncryptionCertificateHashList
9. OpenEncryptedFileRaw
10. QueryRecoveryAgentsOnEncryptedFile
11. QueryUsersOnEncryptedFile
12. ReadEncryptedFileRaw
13. RemoveUsersFromEncryptedFile
14. SetUserFileEncryptionKey
15. WriteEncryptedFileRaw
• 檔案系統重導 (Redirector)
1. Wow64DisableWow64FsRedirection
2. Wow64EnableWow64FsRedirection
3. Wow64RevertWow64FsRedirection
• 解壓縮 Lempel-Ziv 演算法壓縮的檔案
1. GetExpandedName
2. LZClose
3. LZCopy
4. LZInit
5. LZOpenFile
6. LZRead
7. LZSeek
• 回呼 (callback) 函式
1. CopyFile2ProgressRoutine
2. CopyProgressRoutine
3. ExportCallback
4. FileIOCompletionRoutine
5. ImportCallback
• 輔助操作
1. AreFileApisANSI
2. GetBinaryType
3. GetCompressedFileSize
4. GetCompressedFileSizeTransacted
5. GetFileBandwidthReservation
6. GetFileSize
7. GetFileSizeEx
8. GetFileType
9. GetFinalPathNameByHandle
10. GetFullPathName
11. GetFullPathNameTransacted
12. GetLongPathName
13. GetLongPathNameTransacted
14. GetShortPathName
15. GetTempFileName
16. GetTempPath
17. SearchPath
18. SetFileApisToANSI
19. SetFileApisToOEM
20. SetFileBandwidthReservation
21. SetFileShortName
22. SetFileValidData
23. SetSearchPathMode
• 檔案基本操作
1. CopyFile
2. CopyFile2
3. CopyFileEx
4. CopyFileTransacted
5. CreateIoCompletionPort
6. CreateFile
7. CreateFile2
8. CreateFileTransacted
9. CreateHardLink
10. CreateHardLinkTransacted
11. CreateSymbolicLink
12. CreateSymbolicLinkTransacted
13. DeleteFile
14. DeleteFileTransacted
15. GetFileAttributes
16. GetFileAttributesEx
17. GetFileAttributesTransacted
18. GetFileInformationByHandle
19. GetFileInformationByHandleEx
20. MoveFile
21. MoveFileEx
22. MoveFileTransacted
23. MoveFileWithProgress
24. OpenFile
25. OpenFileById
26. ReOpenFile
27. ReplaceFile
28. SetFileAttributes
29. SetFileAttributesTransacted
30. SetFileInformationByHandle
• 檔案搜尋
1. FindClose
2. FindFirstFile
3. FindFirstFileEx
4. FindFirstFileNameTransactedW
5. FindFirstFileNameW
6. FindFirstFileTransacted
7. FindFirstStreamTransactedW
8. FindFirstStreamW
9. FindNextFile
10. FindNextFileNameW
11. FindNextStreamW
• Wof (Windows Overlay File System)
1. WofEnumEntries
2. WofEnumEntryProc
3. WofEnumFilesProc
4. WofFileEnumFiles
5. WofGetDriverVersion
6. WofIsExternalFile
7. WofSetFileDataLocation
8. WofShouldCompressBinaries
9. WofWimAddEntry
10. WofWimEnumFiles
11. WofWimRemoveEntry
12. WofWimSuspendEntry
13. WofWimUpdateEntry

說到檔案 API 也不能不談到目錄 (directory) 操作的 API ，目前總共有 11 個，依序字母開頭排序如下：

1. CreateDirectory
2. CreateDirectoryEx
3. CreateDirectoryTransacted
4. FindCloseChangeNotification
5. FindFirstChangeNotification
6. FindNextChangeNotification
7. GetCurrentDirectory
8. ReadDirectoryChangesW
9. RemoveDirectory
10. RemoveDirectoryTransacted
11. SetCurrentDirectory

將目錄操作的 API 進行分類整理，我們可以分成下列 4 類

• 建立目錄
1. CreateDirectory
2. CreateDirectoryEx
3. CreateDirectoryTransacted
• 變更通知
1. FindCloseChangeNotification
2. FindFirstChangeNotification
3. FindNextChangeNotification
4. ReadDirectoryChangesW
• 當前目錄
1. GetCurrentDirectory
2. SetCurrentDirectory
• 刪除目錄
1. RemoveDirectory
2. RemoveDirectoryTransacted

參考資料：

• File Management Functions
  https://msdn.microsoft.com/en-us/library/windows/desktop/aa364232(v=vs.85).aspx
• Directory Management Functions
  https://msdn.microsoft.com/en-us/library/windows/desktop/aa363950(v=vs.85).aspx

###