在 Windows 操作系统中，CreateFile 函数是其中一个最常用的系统调用，这个函数可以通过文件路径和名称创建一个新的文件，也可以打开一个已经存在的文件进行读取或写入操作。CreateFile 函数接受不同的参数值作为选项，以便满足特定的文件操作需求。在本文中，我们将讨论如何使用 CreateFile 函数在 Windows 中创建新文件以及一些相关的参数选项。

一、了解 CreateFile 函数的基本选项

在 Windows 中，使用 CreateFile 函数创建一个新文件需要提供文件的路径和名称、操作模式（读、写、追加等）、文件属性等基本信息，这些信息可以通过一组常用的选项参数指定。下面列出 CreateFile 函数中常用的选项参数：

1. 文件路径和名称：这个参数指定了文件存储的位置和文件名称。可以是相对或绝对路径。需要注意的是，如果指定的文件路径和名称已经存在，CreateFile 函数则会打开该文件，而不是创建一个新的文件。

2. 文件访问模式和权限：这个参数指定了文件的操作模式和访问权限。可以是只读、只写、读写等，还可以指定是否允许其它进程同时操作该文件，如是否进行锁定等等。

3. 文件共享选项：这个参数指定了文件的共享属性，如是否允许其它进程通过文件句柄访问该文件，是否允许新的进程访问该文件等。

4. 创建新的文件属性和标志：这个参数是一个可选项，可以指定新文件的一些属性和标志，如文件的大小、文件的创建时间和修改时间等。

二、代码示例：使用 CreateFile 函数创建新文件

为了更好地说明 CreateFile 函数的使用方法，我们将提供一个示例代码，通过这个示例代码来创建一个新的文本文件并写入数据。这其中包括了一系列的函数调用过程，让读者可以更直观地了解到 CreateFile 函数中各个参数的作用。

```c

#include

#include

int main()

{

HANDLE hFile;

DWORD dwBytesWritten;

char data[] = "Hello, world!";

hFile = CreateFile(

"C:/temp/newfile.txt", // 文件路径和名称

GENERIC_WRITE, // 写入模式

0, // 禁止共享模式

NULL, // 默认安全描述符

CREATE_NEW, // 如果文件已经存在，则创建失败

FILE_ATTRIBUTE_NORMAL, // 默认文件属性

NULL); // 没有模板文件

if (hFile == INVALID_HANDLE_VALUE)

{

printf("CreateFile failed (%d)\n", GetLastError());

return 1;

}

if (!WriteFile(

hFile, // 文件句柄

data, // 写入数据

sizeof(data),// 数据长度

&dwBytesWritten, // 实际写入数据的长度

NULL)) // 不需要指定 overlapped 结构

{

printf("WriteFile failed (%d)\n", GetLastError());

CloseHandle(hFile);

return 1;

}

CloseHandle(hFile);

return 0;

}

```

在这个示例代码中，我们使用指定的路径和名称 "C:/temp/newfile.txt" 创建一个新的文本文件，以写入模式打开该文件，禁止对该文件进行共享操作，不指定安全描述符。如果文件已经存在，则创建失败。默认的文件属性也使用了默认的 FILE_ATTRIBUTE_NORMAL，我们没有指定模板文件。

我们在代码中还通过了 WriteFile 函数实现将数据写入新文件的操作，这个函数与 CreateFile 函数类似，也需要指定文件句柄、数据和数据长度等参数。

请注意，CreateFile 函数的返回值是一个文件句柄，即一个指向文件的指针。使用文件句柄进行文件操作时要记得关闭文件，CloseHandle 函数用于释放文件句柄。如果没有使用 CloseHandle 函数，系统将无法释放已经打开的文件，导致资源被浪费，甚至引发难以预料的错误，可能导致系统崩溃。

三、CreateFile 函数的一些进阶选项

除了前文介绍的基本选项，CreateFile 函数还提供了一些进阶选项，用于实现更丰富的文件操作功能。

1. 以异步模式打开文件

异步模式 CreateFile 函数允许访问设备并发执行其它任务。这意味着，如果一个异步操作正在进行中，可以同时进行另一个异步操作，不需要等待前一个操作完成。在CreateFile 函数调用中指定异步 I/O 标志 FILE_FLAG_OVERLAPPED，以使用异步模式打开文件。

2. 更改文件位置指针

SetFilePointer 函数可以在已经打开的文件中移动文件指针。在 SetFilePointer 函数中使用文件句柄、需要移动文件指针的字节数以及移动文件指针的方式进行操作。移动文件指针的方式可以是从文件头、从当前位置或者从文件末尾开始移动。

3. 连续写入文件数据

如果需要将较大的数据连续写入到文件中，并且写入数据的速度比读取速度快，则可以通过 FILE_FLAG_WRITE_THROUGH 参数来提高写入数据的效率，这个参数可以强制立即将数据从内存写入磁盘。当然，这也会导致读取数据的效率降低。

四、总结

CreateFile 函数是 Windows 操作系统中最常用的函数之一，它可以创建、打开和操作文件。在使用 CreateFile 函数时，需要提供文件的路径和名称、文件的操作模式、访问权限以及如何共享文件等信息。除此之外，CreateFile 函数还支持一些进阶选项，如使用异步模式操作文件、SetFilePointer 函数来更改文件指针、FILE_FLAG_WRITE_THROUGH 参数来提高写入数据的效率等。

无论是进行数据的读取还是写入，CreateFile 函数的使用都十分重要，我们必须掌握这个函数的不同选项参数以及如何在程序代码中正确的调用 CreateFile 函数。