[WinAPI] API 9 [文件的刪除、復制和移動功能]

 

 

Windows系統為文件的刪除、復制、重命名或移動文件提供了相應的API函數。刪除文件使用DeleteFile函數；復制文件使用CopyFile函數；重命名文件和移動文件實際是一個操作，使用MoveFile函數。這幾個函數的使用都非常簡單，下面分別介紹。

(1) DeleteFile。
DeleteFile的功能是刪除文件。以文件路徑作為輸入，指向需要刪除的文件。文件路徑可以是類似於“c：\files\delete.txt”的絕對路徑，也可以是類似於“.\delete.txt”的相對路徑，二相對於可執行文件所在的路徑。
◇參數
lpFileName:輸入參數，所要刪除的文件的相對路徑或絕對路徑。
◇返回值
返回BOOL值，表示文件刪除是否成功。
◇使用說明
如果程序返回失敗，可以使用GetLastError函數獲取錯誤信息。

 

(2) CopyFile。
CopyFile的功能是復制文件。通過參數輸入復制文件和源路徑和目的路徑，路徑可以是絕對路徑也可以是相對路徑，還可以通過參數指明如果目的路徑已經存在文件，是否覆蓋。可以使用CopyFileEx函數進行更為高級的操作，比如在復制進行過程中取消復制等。CopyFileEx可以指定
一個回調函數來處理文件復制中所可能發生的各種情況。
◇參數
lpExistingFileName:輸入參數，已經存在的所需復制文件的源路徑。
lpNewFileName:輸入參數，新文件路徑，復制文件的目的路徑。
bFailIfExists:輸入參數，指明如果在目的路徑存在文件時是否覆

將不覆蓋已經存在的文件，如果存在，則返回失敗。這時使用GetLastError獲取錯誤代碼，將返回80(Ox50)。
◇返回值
返回BOOL值，表示文件復制是否成功。
◇使用說明
如果程序返回失敗，可以使用GetLastError函數獲取錯誤信息。

(3) MoveFile。
MoveFile的功能是移動、重命名文件和目錄。通過參數輸入源路徑和目的路徑，路徑可以是絕對路徑也可以是相對路徑，如果目的路徑的文件或目錄已經存在，則返回失敗。可以使用MoveFileEx函數來指定更多的選項，如果已經存在是否替換等。還可以使用MoveFileWithProgress指定一個回調函數來處理文件移動中所可能發生的各種情況。

◇參數
lpExistingFileName：輸入參數，為已經存在的所需移動文件的源路徑。
lpNewFileName：輸入參數，新文件路徑，移動文件的目的路徑。
◇返回值
返回BOOL值，表示文件移動是否成功。
◇使用說明
如果程序返回失敗，可以使用GetLastError函數獲取錯誤信息。

(4) CopyFileEx、MoveFileEx以及MoveFileWithProgreSS.
這3個API函數功能更豐富,不再做詳細介紹.

 

本實例使用DeleteFile、CopyFile、MoveFile來完成文件的刪除、復制和移動功能。編譯生成可執行文件，通過參數來指定程序完成的功能。-d參數表示刪除文件，后面跟所需刪除的文件路徑；-m參數表示移動、重命名文件，之后的參數分別是源路徑和目的路徑；-c參數表示復制文件，之后跟源路徑和目的路徑。在復制文件過程中，如果文件已經存在，會提醒用戶是否覆蓋。

 

 

/* ************************************
*《精通Windows API》 
* 示例代碼
* wr.c
* 4.3.2    創建、打開、讀寫文件，獲取文件大小
**************************************/

/* 頭文件　*/
#include <windows.h>
#include <stdio.h>

/* ************************************
* DWORD ReadFileContent(LPSTR szFilePath)
* 功能    獲取文件大小
*        讀取文件內容，並以16進制的形式打印出來
* 參數    LPSTR szFilePath
*        文件路徑
**************************************/
DWORD ReadFileContent(LPSTR szFilePath)
{
    //文件大小
    HANDLE hFileRead;
    //保存文件大小
    LARGE_INTEGER liFileSize;
    //成功讀取的文件數據大小
    DWORD dwReadedSize;
    //累加計算已經讀取數據的大小
    LONGLONG liTotalRead = 0;
    //文件數據緩存
    BYTE lpFileDataBuffer[32];

    //打開已經存在的文件，讀取內容。    
    hFileRead = CreateFileA(szFilePath,// 要打開的文件名
        GENERIC_READ,               // 以讀方式打開
        FILE_SHARE_READ,           // 可共享讀
        NULL,                      // 默認安全設置
        OPEN_EXISTING,             // 只打開已經存在的文件
        FILE_ATTRIBUTE_NORMAL,     // 常規文件屬性
        NULL);                     // 無模板

    //打開文件是否成功。
    if(hFileRead==INVALID_HANDLE_VALUE)
    {
        printf("打開文件失敗：%d",GetLastError());
    }

    if(!GetFileSizeEx(hFileRead,&liFileSize))
    {
        printf("獲取文件大小失敗：%d",GetLastError());
    }
    else
    {
        printf("文件大小為：%d/n",liFileSize.QuadPart);
    }

    //循環讀取並打印文件內容
    while(TRUE)
    {
        DWORD i;

        if(!ReadFile(hFileRead,    //讀文件的句柄
            lpFileDataBuffer,    //存儲讀取的文件內容
            32,                    //讀的大小（字節）
            &dwReadedSize,        //實際讀取的大小
            NULL))                //不使用Overlapped
        {
            printf("讀文件錯誤：%d/n",GetLastError());
            break;
        }
        printf("讀取了%d字節，文件內容是：",dwReadedSize);
        
        for(i=0; i<dwReadedSize; i++)
        {
            printf("0x%x ",lpFileDataBuffer[i]);
        }
        printf("/n");
        liTotalRead += dwReadedSize;
        if(liTotalRead == liFileSize.QuadPart)
        {
            printf("讀文件結束/n");
            break;
        }
    }
    CloseHandle(hFileRead);
    return 0;
}

/* ************************************
*  SaveDataToFile
* 功能    將數據存儲到文件末尾
* 參數    LPSTR szFilePath    文件路徑
*        LPVOID lpData        需存儲的數據
*        DWORD dwDataSize    數據大小（字節）
**************************************/
DWORD SaveDataToFile(
                     LPSTR szFilePath,
                     LPVOID lpData,
                     DWORD dwDataSize)
{
    //文件句柄
    HANDLE hFileWrite;
    //成功寫入的數據大小
    DWORD dwWritedDateSize;

    //打開已經存在的文件，讀取內容。    
    hFileWrite = CreateFileA(szFilePath,    // 要打開的文件名
        GENERIC_WRITE,            // 以寫方式打開
        0,                        // 可共享讀
        NULL,                    // 默認安全設置
        OPEN_ALWAYS,            // 打開已經存在的文件，沒用則創建
        FILE_ATTRIBUTE_NORMAL,    // 常規文件屬性
        NULL);                    // 無模板
    
    //判斷是否打開成功
    if(hFileWrite==INVALID_HANDLE_VALUE)
    {
        printf("打開文件失敗：%d/n",GetLastError());
    }

    //設置文件指針到文件尾
    SetFilePointer(hFileWrite,0,0,FILE_END);

    //將數據寫入文件
    if(!WriteFile(hFileWrite,lpData,dwDataSize,&dwWritedDateSize,NULL))
    {
        printf("寫文件失敗：%d/n",GetLastError());
    }
    else
    {
        printf("寫文件成功，寫入%d字節。/n",dwWritedDateSize);
    }
    CloseHandle(hFileWrite);
    return 0;
}

/* ************************************
* int main(void)
* 功能    演示使用SaveDataToFile和ReadFileContent函數
**************************************/
int main(void)
{
    LPSTR szFileData = "這是一個例子";
    SaveDataToFile("C://show.txt",szFileData,lstrlenA(szFileData));
    ReadFileContent("C://show.txt");
    return 0;
}