(Windows編程 文件專題)打開,讀取,寫入和關閉文件
關鍵詞
C++ CreateFile CloseHandle ReadFile WriteFile API 文件句柄
◆CreateFile
HANDLE CreateFile(
LPCTSTR lpName,
DWORD dwAccess,
DWORD dwShareMode,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreate,
DWORD dwAttrsAndFlags,
HANDLE hTemplateFile)
返回值:所創建文件對象的句柄,如果文件創建失敗則返回
INVALID_HANDLE_VALUE
lpName 是以null結尾的對文件,管道或其他打開和創建的命名對象進行命名的字符串的指針.
dwAccess 使用 GENERIC_READ 和 GENERIC_WRITE 來指定讀寫訪問(見WINNT.H中宏定義),允許使用位操作符(或)合并
dwShareMode是以下二進制方式的(或)操作
● 0——文件不能共享，甚至該進程不能打開該文件的第二個句柄
● FILE_SHARE_READ——其他進程包括調用進程可以打開該文件進行并發讀訪問
● FILE_SHARE_WRITE——它允許對文件進行并發寫操作
lpSecurityAttributes 指向了 SECRITY_ATTRIBUTES 結構。
dwCreate指定了是否創建一個新的文件，是否重寫現有的文件等等，允許(或)操作
● CREATE_NEW——如果指定的文件已經存在，操作失敗，否則創建新的文件
● CREATE_ALWAYS ——現有的文件將被改寫
● OPEN_EXISTING——如果文件不存在，操作失敗
● OPEN_ALWAYS——打開文件，如果文件不存在則創建
● TRUNCATE_EXISTING——文件長度設為零，需要dwCreate指定GENERIC_WRITE，
如果文件已存在，所有內容將會破壞
dwAttrsAndFlags 指定了文件屬性和標記。有16個標記和屬性
● FILE_ATTRIBUTE_NORMAL 該屬性只有在其他屬性沒有設置時才有用
● FILE_ATTRIBUTE_READONLY 程序不能改寫也不能刪除文件
● FILE_FLAG_DELETE_ON_CLOSE 對于臨時文件很有用。
當最后一個HANDLE關閉時，文件就被刪除
● FILE_FLAG_OVERLAPPED 該屬性標記對于異步I/O很重要
● FILE_FLAG_WRITE_THROUGH 直接對磁盤文件進行中間緩存寫操作
● FILE_FLAG_NO_BUFFERING 沒有中間緩存，數據傳輸直接在程序中由 ReadFile和
WriteFile 調用指定的數據緩存上實現。相應地，在扇區地邊界處也需要緩存，而且完
整地扇區必須被傳輸。在使用該標記時，通過調用函數 GetDiskFreeSpace 來決定扇
區的大小
● FILE_FLAG_RANDOM_ACCESS 主要用于隨機訪問，而 Windows 也會盡量優化文件
緩存
● FILE_FLAG_SEQUENTIAL_SCAN 主要用于順序訪問，而 Windows也會對文件緩存作
相應優化
hTemplateFile 是打開的 GENERIC_READ 文件的句柄，該文件指定了用于新創建的文件的擴展屬性，并忽略了 dwAttrsAndFlags。通常參數是NULL，當現有的文件已打開時，hTemplateFile 被忽略。該參數可用來將新文件的屬性設置成跟現有文件的屬性相同
如果文件共享屬性和安全性允許，文件會有許多打開的句柄。打開的句柄可以由相同或不同的進程所擁有
◆關閉文件
BOOL CloseHandle(HANDLE hObject)
返回值：如果本函數成功執行，返回TRUE，否則返回FALSE。
一個萬能的函數關閉，句柄會銷毀，所有對象的系統資源也會釋放。當然也會有異常情況。關閉句柄也減少了對象的句柄引用計數，這樣非永久的對象比如臨時文件和事件將被刪除。系統在退出時會關閉所有打開句柄，但是在程序終止前關閉其句柄是個很好的習慣。
關閉一個無效的句柄或對同一個句柄關閉兩次將會引起異常，而關閉標準設備句柄是不必要的或不適宜的
◆讀取文件
BOOL ReadFile(
HANDLE hFile,
LPVOID lpBuffer,
DWORD nNumberOfBytesToRead,
LPDWORD lpNumberOfBytesRead,
LPOVERLAPPED lpOverlapped)
返回值：如果文件讀取操作成功執行，則返回TRUE(即使試圖讀取文件末尾后的內容，未能讀取到任何字節，仍舊返回TRUE)。
hFile 是具有GENERIC_READ 訪問權限的文件句柄。
lpBuffer指向接受輸入數據的內存緩存
nNumberOfBytesToRead 是從文件中讀取的字節數，如果句柄位于文件的末尾處或有錯誤時，其值可以是零。消息模式的命名管道允許0長度的消息。
lpOverlapped 指向了OVERLAPPED結構，現在使用NULL
如果dwAttrsAndFlags中沒有設置選項 FILE_FLAG_OVERLAPPED。那么ReadFile從句柄的當前文件位置開始，隨著傳輸字節數往前移動位置。
如果句柄或任何其它參數無效，函數失敗并返回FALSE，如果文件句柄位于文件末尾處，函數不會失敗，取而代之，讀取字節數 (*lpNumberOfBytesRead)被設為0。
◆寫文件
BOOL WriteFile(
HANDLE hFile,
LPCVOID lpBuffer,
DWORD nNumberOfBytesToWrite,
LPDWORD lpNumberOfBytesWritten,
LPOVERLAPPED lpOverlapped)
返回值：如果本函數成功執行，則返回TRUE，否則返回FALSE
注意一個成功的寫操作不能確保數據真正被寫入硬盤中，除非在CreateFile中指定FILE_FLAG_WRITE_THROUGH。如果句柄位于文件的末尾，Windows會擴展現有的文件的長度。
ReadFileGather 和WriteFileGather 允許使用不同大小的緩存來進行讀寫操作。
附：
示例文件(CPW.cpp)
/* 使用Windows API 實現文件復制???? */
/* cpw.cpp?????? */
#include <windows.h>
#include <stdio.h>
#define BUF_SIZE 256
int main(int argc,LPTSTR argv[]){
HANDLE hIn,hOut;
DWORD nIn,nOut;
CHAR Buffer[BUF_SIZE];
if(argc != 3){
???? printf("Usage:cpw file1 file2\n");
???? return 1;
}
hIn = CreateFile(argv[1],GENERIC_READ,0,NULL,OPEN_EXISTING,0,NULL);
if (hIn == INVALID_HANDLE_VALUE){
???? printf("Can't open input file.Error:%x\n",GetLastError());
???? return 2;
}
hOut = CreateFile(argv[2],GENERIC_WRITE,0,NULL,CREATE_ALWAYS,FILE_ATTRIBUTE_NORMAL,NULL);
if (hOut == INVALID_HANDLE_VALUE){
???? printf("Can't open output file.Error:%x\n",GetLastError());
???? return 3;
}
while(ReadFile(hIn,Buffer,BUF_SIZE,&nIn,NULL) && nIn>0){
???? WriteFile(hOut,Buffer,nIn,&nOut,NULL);
???? if(nIn != nOut){
????? printf("Fatal write error:%x\n",GetLastError());
????? return 4;
???? }
}
CloseHandle(hIn);
CloseHandle(hOut);
return 0;
}