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