Win32 API: CreateFileA function (fileapi.h)

翻译自: CreateFileA function (fileapi.h)

创造或打开了一个文件或I/O设备，最常用的I/O设备如下: 文件、文件流、文件路径、物理盘、卷、控制台缓冲区、… …

函数返回一个句柄，该句柄能够被用于访问不同的I/O的文件或设备。

句法规范:

HANDLE CreateFileA(
  [in]           LPCSTR                lpFileName,
  [in]           DWORD                 dwDesiredAccess,
  [in]           DWORD                 dwShareMode,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  [in]           DWORD                 dwCreationDisposition,
  [in]           DWORD                 dwFlagsAndAttributes,
  [in, optional] HANDLE                hTemplateFile
);

参数

1.[in] lpFileName
要被创造或打开的文件名或设备名。

2.[in] dwDesiredAccess
请求的对文件或设备的访问，可以总结为读、写、都或0表示都不。最常用的值是GENERIC_READ、GENERIC_WRITE, 或读写都有(GENERIC_READ | GENERIC_WRITE)。

3.[in] dwShareMode
文件或设备所需要的共享模式，可以是读、写、读写兼有、删除、所有这些兼有，或者是其他值。如果此参数为0并且CreateFile函数成功执行, 文件或设备就不能被分享并且不能被再次打开直到句柄被关闭。

4.[in, optional] lpSecurityAttributes
这个参数可以为NULL。

5.[in] dwCreationDisposition
一个在设备或文件上执行的动作。对于文件以外的设备，通常被设置成OPEN_EXISTING

6.[in] dwFlagsAndAttributes
这个参数暂时默认的值就是FILE_ATTRIBUTE_NORMAL

7.[in, optional] hTemplateFile
暂时设置为NULL

返回值:

一旦函数失败，就会返回INVALID_HANDLE_VALUE。如果成功，返回值就是一个打开的句柄。