API---文件操作

CreateFile() 介绍：

功能：打开或创建以下对象，并返回可访问的句柄：

          控制台，通信资源，目录(只读打开)，磁盘驱动器，文件，邮槽，管道。

函数原型：HANDLE CreateFile (

                  LPCTSTR lpFileName,    // 指向文件或其它设备名的指针。详情可见 CreateFile() 详解
                  DWORD dwDesiredAccess,    // 访问模式（写 / 读）

                  DWORD dwShareMode,    // 共享模式 
                  LPSECURITY_ATTRIBUTES lpSecurityAttributes, // 指向安全属性的指针，一般为 NULL。 
                  DWORD dwCreationDisposition,   // 如何创建 
                  DWORD dwFlagsAndAttributes,   // 文件属性 
                  HANDLE hTemplateFile    // 用于复制文件句柄 
                  );

参数：( 可组合) 

          lpFileName：若为命名管道服务器，则该值形式为：“\.pipepipename”，

                                若为命名管道客户端，则该值形式为："\servernamepipepipename"。

                                若为邮件槽服务器，则该值形式为："\.mailslotmailslotname"，

                                若为邮件槽客户端，则该值形式为："\servernamemailslotname"。

          dwDesiredAccess：GENERIC_READ , GENERIC_WRITE, 0 (只允许获取与设备有关的信息) 。

          dwShareMode：FILE_SHARE_DELETE, FILE_SHARE_READ, FILE_SHARE_WRITE, 0 (不共享)。

          lpSecurityAttributes：指向一个 SECURITY_ATTRIBUTES 结构的指针。

          dwCreationDisposition：

                                              CREATE_NEW 创建文件；如文件存在则会出错。
                                              CREATE_ALWAYS 创建文件，会改写前一个文件。
                                              OPEN_EXISTING 文件必须已经存在。由设备提出要求。
                                              OPEN_ALWAYS 如文件不存在则创建它。
                                              TRUNCATE_EXISTING 将现有文件缩短为零长度。
          dwFlagsAndAttributes：
                                               FILE_ATTRIBUTE_ARCHIVE 标记归档属性
                                               FILE_ATTRIBUTE_COMPRESSED 将文件标记为已压缩或者标记为文件在目录中的默认压缩方式
                                               FILE_ATTRIBUTE_NORMAL 默认属性
                                               FILE_ATTRIBUTE_HIDDEN 隐藏文件或目录
                                               FILE_ATTRIBUTE_READONLY 文件为只读
                                               FILE_ATTRIBUTE_SYSTEM 文件为系统文件
                                               FILE_FLAG_WRITE_THROUGH 操作系统不得推迟对文件的写操作
                                               FILE_FLAG_OVERLAPPED 允许对文件进行重叠操作
                                               FILE_FLAG_NO_BUFFERING 禁止对文件进行缓冲处理。文件只能写入磁盘卷的扇区块
                                               FILE_FLAG_RANDOM_ACCESS 针对随机访问对文件缓冲进行优化
                                               FILE_FLAG_SEQUENTIAL_SCAN 针对连续访问对文件缓冲进行优化
                                               FILE_FLAG_DELETE_ON_CLOSE 关闭了上一次打开的句柄后，将文件删除。
          hTemplateFile：如果不为零，则指定一个文件句柄，新文件将从这个文件中复制和扩展属性。
 
返回值：如执行成功，则返回文件句柄。否则返回 INVALID_HANDLE_VALUE。
 
struct _SECURITY_ATTRIBUTES 结构体：
// 主要作用是决定 CreateFile() 返回的句柄是否可以被子进程继承。
// 该值通常设置为 NULL 表示不能被继承。
typedef struct _SECURITY_ATTRIBUTES {
DWORD nLength; / /结构体的大小，可用SIZEOF取得
LPVOID lpSecurityDescriptor; / /安全描述符(一般为 NULL)
BOOL bInheritHandle ;/ /安全描述的对象能否被新创建的进程继承
} SECURITY_ATTRIBUTES，* PSECURITY_ATTRIBUTES;

CloseHandle() 介绍：

功能：关闭一个内核对象。其中包括文件、文件映射、进程、线程、安全和同步对象等。
函数原型：BOOL CloseHandle( HANDLE hObject ) ;
参数：hObject Long，欲关闭的一个对象的句柄。
返回值：非零表示成功，零表示失败。
 
ReadFile() 介绍：
功能：从文件指针指向的位置开始将数据读出到一个文件中, 且支持同步和异步操作。

函数原型：BOOL ReadFile(

　　           HANDLE hFile, //文件的句柄。
　　           LPVOID lpBuffer, //用于保存读入数据的一个缓冲区。
　　           DWORD nNumberOfBytesToRead, //指定需要要读入的字符数。
　　           LPDWORD lpNumberOfBytesRead, //返回实际读取字节数的指针。
　　           LPOVERLAPPED lpOverlapped //如文件打开时指定了FILE_FLAG_OVERLAPPED，
       // 那么必须用这个参数引用一个特殊的结构。该结构定义了一次异步读取操作。否则，应将这个参数设为NULL。
　　);
返回值：非零表示成功，零表示失败。
 
WriteFile() 介绍：
功能：从文件指针指向的位置开始将数据写入到一个文件中, 且支持同步和异步操作。
函数原型：BOOL WriteFile(
                  HANDLE       hFile,    // 文件句柄
                  LPCVOID      lpBuffer,  // 要写入的数据。
                  DWORD        nNumberOfBytesToWrite,  // 要写入的字节数。
                  LPDWORD      lpNumberOfBytesWritten, // 实际写入的字节数。
                  LPOVERLAPPED lpOverlapped       //  同 ReadFile(), 一般设置为 NULL。
);
返回值：非零表示成功，零表示失败。
 
SetFilePointer() 介绍：
功能：在一个文件中设置当前的读取位置。
函数原型：DWORD SetFilePointer(
                  HANDLE hFile, // 文件句柄。
                  LONG lDistanceToMove, // 偏移量(低位)。
                  PLONG lpDistanceToMoveHigh, // 偏移量(高位)。( 通常为 NULL)
                  DWORD dwMoveMethod // 基准位置：
                                                               FILE_BEGIN:文件开始位置。
                                                               FILE_CURRENT:文件当前位置 。
                                                               FILE_END:文件结束位置。
返回值：返回一个新位置，HFILE_ERROR意味着出错。
 
DeleteFile() 介绍：
功能：删除指定文件或目录。
函数原型：BOOL DeleteFile(
                  LPCSTR  lpFileName // 指向要删除的文件。
                  );
返回值：非零表示成功，零表示失败。
 
 CreateDirectory() 介绍：
功能：创建新的目录。
函数原型：BOOL CreateDirectoryA(
                  LPCSTR                lpPathName,   //目录路径名。
                  LPSECURITY_ATTRIBUTES lpSecurityAttributes  // 安全属性，同 CreateFile() ;
                  );
返回值：非零表示成功，零表示失败。
 
RemoveDirectory() 介绍：
功能：删除目录。
函数原型：BOOL RemoveDirectory(
                  LPCTSTR lpPathName // 指向要删除的目录。
                  );
返回值：非零表示成功，零表示失败。
 
CopyFile() 介绍：
功能：复制文件或目录。
函数原型：BOOL CopyFile(
                  LPCTSTRlpExistingFileName,  // 指向源文件名。
                  LPCTSTR lpNewFileName, // 指向目标文件名。
                  BOOL bFailIfExists     // 文件操作标志。指明如果在目的路径存在文件时是否覆盖。
                  //如果设为TRUE（非零），将不覆盖已经存在的文件。否则覆盖已存在的文件。
                  );
返回值：非零表示成功，零表示失败。
 
MoveFile() 介绍：
功能：移动文件或目录位置。
函数原型：BOOL MoveFile(
                  LPCTSTR lpExistingFileName, // 指向源文件名。
                  LPCTSTR lpNewFileName // 指向目标文件名。
                  );
返回值：非零表示成功，零表示失败。
 

GetModuleFileName() 介绍：

功能：获取当前进程已加载模块的文件的完整路径，该模块必须由当前进程加载。

函数原型：DWORD WINAPI GetModuleFileName(

                  HMODULE  hModule,   // 表示正在被加载模块的句柄。

                                                        //如果为 NULL,则将当前可执行文件的完整路径复制到 lpFilename 中

                  LPTSTR  lpFileName,  //  指向保存完整路径的文件名。

                  DWORD  nSize       // 表示复制到 lpFileName 的最大字符数量。

                  ); 

返回值：如执行成功，返回复制到lpFileName的实际字符数量；零表示失败。

GetFileTitle() 介绍：

功能：从指定的文件路径中获取文件的名称。

(例如指定文件路径为：C:UsersPublicDocumentsTest.txt，则文件名称为 Test。

函数原型：short GetFileTitleA(
                  LPCSTR Path, // 指定的文件路径。
                  LPSTR  Buf, // 接收文件名称的缓冲区。
                  WORD  cchSize  // 缓冲区的大小。
                  );

返回值：如果函数成功, 则返回值为零。如果文件名无效, 则返回值未知。如果出现错误, 返回值为负数。

 
GetSystemDirectory() 介绍：
功能：取得Windows系统目录 (System目录) 的完整路径名。
函数原型：UINT WINAPI GetSystemDirectory(
                  LPTSTR lpBuffer,   // 指向要接收路径的缓冲区的指针。
                  UINT   uSize    // 缓冲区的最大大小.
                  );
返回值：如果函数成功, 则返回值是复制到缓冲区的字符串的长度。如果函数失败, 则返回值为零。
 
SetFileAttributes() 介绍：
功能：设置文件或目录属性。
函数原型：BOOL SetFileAttributes(

                  LPCTSTR lpFileName,     // 指定的文件名。

                  DWORD dwFileAttributes  // 文件属性(值如下表：)。

                  );

返回值：非零表示成功，零表示失败。

属性
含义
FILE_ATTRIBUTE_ARCHIVE
该文件是一个存档文件。应用程序使用此属性来备份或移除标记文件。
FILE_ATTRIBUTE_HIDDEN
该文件是隐藏的。它不包括在普通的目录列表。
FILE_ATTRIBUTE_NORMAL
该文件没有设置其他的属性。此属性仅在单独使用有效。
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED
该文件将不被内容索引服务编制索引。
FILE_ATTRIBUTE_OFFLINE
该文件的数据不是立即可用。
此属性表明文件数据被物理移动到离线存储。
此属性用于通过远程存储，分层存储管理软件。
应用程序不应随意更改此属性。
FILE_ATTRIBUTE_READONLY
该文件是只读的。应用程序可以读取该文件，但不能写入或删除它。
FILE_ATTRIBUTE_SYSTEM
该文件是操作系统的一部分，或者完全由它使用。
FILE_ATTRIBUTE_TEMPORARY
该文件是被用于暂时存储。文件系统避免写入数据传回海量存储
如果有足够的缓存内存可用，因为经常在应用程序删除后不久
，这个句柄被关闭的临时文件。在这种情况下，该系统可以完全避免记录的数据。否则，在手柄关闭的数据将被写入。

GetFileAttributes() 介绍：

功能：为一个指定的文件或目录返回文件系统的属性。

函数原型：DWORD GetFileAttributes(
                  LPCSTR lpFileName  // 指定的文件名。
                  );

返回值：如果函数成功，返回值包含文件或目录的属性。

              如果函数失败，返回值是INVALID_FILE_ATTRIBUTES。

属性 含义
FILE_ATTRIBUTE_ARCHIVE 标示一个文件（或目录）是一个存档文件（或目录）。
FILE_ATTRIBUTE_COMPRESSED
标示一个文件（或目录）是一个压缩文件（或目录）。
用于文件时：该文件中所有的记录都是经过压缩的；
用于目录时：在该目录下新建文件或子目录时会默认进行压缩。
FILE_ATTRIBUTE_DIRECTORY 此句柄被视为一个目录
FILE_ATTRIBUTE_ENCRYPTED
标示一个文件（或目录）是一个加密文件（或目录）。
用于文件时：该文件中所有的记录都是经过加密的，包括读写操作；
用于目录时：在该目录下新建文件或子目录时会默认进行加密。
FILE_ATTRIBUTE_HIDDEN 标示一个文件（或目录）是一个隐藏文件（或目录）。
FILE_ATTRIBUTE_NORMAL 标示一个文件（或目录）不具有其他属性，此属性只能单独使用！
FILE_ATTRIBUTE_NOT_CONTENT_INDEXED 标示一个文件不可被内容索引服务索引。
FILE_ATTRIBUTE_OFFLINE
标示一个文件是脱机文件，该文件中的内容无法直接使用。
如果某个文件具有该属性，请不要轻易修改此属性，它可能是某些远程存储服务程序的存储文件。
FILE_ATTRIBUTE_READONLY
标示一个文件（或目录）是一个只读文件（或目录）。
用于文件时：只能读取文件内容，无法修改或删除；
用于目录时：该目录无法删除。
FILE_ATTRIBUTE_REPARSE_POINT 标示一个文件（或目录）拥有相关的重新解析点，比如用mklink创建的硬链接或符号链接。
FILE_ATTRIBUTE_SPARSE_FILE 标示一个文件是稀疏文件。
FILE_ATTRIBUTE_SYSTEM 标示一个文件（或目录）是一个系统文件（或目录）。
FILE_ATTRIBUTE_TEMPORARY 标示一个文件是临时文件。
 
DEMO CODE:
#include<stdio.h>
#include<Windows.h>
int main(void)
{
    HANDLE hFile;
    BOOL Bool;
    TCHAR lpBuffer[MAX_PATH];
    LPDWORD Num = 0;
    hFile = CreateFile("C:\Users\Public\Documents\Test.txt",
        GENERIC_ALL,
        NULL,
        NULL,
        CREATE_ALWAYS,
        FILE_ATTRIBUTE_HIDDEN,
        NULL);
    if (hFile == INVALID_HANDLE_VALUE)
    {
        printf("Create File Error!
");
        system("pause");
        exit(0);
    }

    printf("Input what you want to write:
");
    gets_s(lpBuffer);

    Bool = WriteFile(hFile,
        lpBuffer,
        MAX_PATH,
        Num,
        NULL);

    if (!Bool)
    {
        printf("Write File Error
");
        system("pause");
        exit(0);
    }

    CloseHandle(hFile);
    printf("Create and Write Succeed
");
    system("pause");
    return 0;
}
【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/M-Anonymous/p/9368742.html