关于createfile的帮助文档
时间: 2023-09-07 10:15:02 浏览: 106
PB系统函数大全帮助文档
`CreateFile` 是一个用于创建或打开文件或设备的 Windows API 函数。其函数原型如下:
```c++
HANDLE CreateFile(
LPCTSTR lpFileName,
DWORD dwDesiredAccess,
DWORD dwShareMode,
LPSECURITY_ATTRIBUTES lpSecurityAttributes,
DWORD dwCreationDisposition,
DWORD dwFlagsAndAttributes,
HANDLE hTemplateFile
);
```
参数说明:
- `lpFileName`:文件名或设备名。
- `dwDesiredAccess`:访问模式。可以是 `GENERIC_READ`、`GENERIC_WRITE` 或 `GENERIC_READ | GENERIC_WRITE`。具体取值请参考官方文档。
- `dwShareMode`:共享模式。可以是 `FILE_SHARE_READ`、`FILE_SHARE_WRITE` 或 `FILE_SHARE_READ | FILE_SHARE_WRITE`。具体取值请参考官方文档。
- `lpSecurityAttributes`:指向一个 `SECURITY_ATTRIBUTES` 结构体的指针,用于指定对象的安全性。若为 `NULL`,则安全属性默认为非继承的。
- `dwCreationDisposition`:文件打开方式。可以是以下值之一:
- `CREATE_NEW`:如果文件不存在,则创建文件;如果文件已存在,则打开失败。
- `CREATE_ALWAYS`:如果文件不存在,则创建文件;如果文件已存在,则覆盖原文件。
- `OPEN_EXISTING`:如果文件不存在,则打开失败;如果文件已存在,则打开文件。
- `OPEN_ALWAYS`:如果文件不存在,则创建文件;如果文件已存在,则打开文件。
- `TRUNCATE_EXISTING`:如果文件不存在,则打开失败;如果文件已存在,则清空文件内容。
- `dwFlagsAndAttributes`:文件属性和标志。可以是以下值之一或其组合:
- `FILE_ATTRIBUTE_ARCHIVE`:归档文件属性。
- `FILE_ATTRIBUTE_DIRECTORY`:目录属性。
- `FILE_ATTRIBUTE_HIDDEN`:隐藏文件属性。
- `FILE_ATTRIBUTE_NORMAL`:普通文件属性(默认值)。
- `FILE_ATTRIBUTE_READONLY`:只读文件属性。
- `FILE_ATTRIBUTE_TEMPORARY`:临时文件属性。
- `FILE_FLAG_DELETE_ON_CLOSE`:文件关闭时删除文件。
- `FILE_FLAG_NO_BUFFERING`:无缓冲区,直接与物理磁盘交互。
- `FILE_FLAG_OVERLAPPED`:异步 I/O 操作标志。
- `FILE_FLAG_RANDOM_ACCESS`:文件随机访问标志。
- `FILE_FLAG_SEQUENTIAL_SCAN`:文件顺序扫描标志。
- `FILE_FLAG_WRITE_THROUGH`:完全同步写入标志。
- `hTemplateFile`:用于复制文件属性的文件句柄。若为 `NULL`,则使用默认文件属性。
函数返回值为文件或设备的句柄,若返回值为 `INVALID_HANDLE_VALUE`,则表示函数执行失败。你可以通过该句柄调用其他 Windows API 函数来操作文件或设备。记得在使用完文件句柄后调用 `CloseHandle` 函数关闭文件句柄,否则可能会导致资源泄露。
阅读全文