fileapi.h 标头

2025-04-11

此标头由多种技术使用。有关详细信息，请参阅：

fileapi.h 包含以下编程接口：

功能


AreFileApisANSI 确定文件 I/O 函数是使用 ANSI 还是 OEM 字符集代码页。
AreShortNamesEnabled AreShortNamesEnabled 函数确定是否为指定卷启用短名称。
CompareFileTime 比较两个文件时间。
CreateDirectory2A 新建目录。（ANSI）
CreateDirectory2W 新建目录。（Unicode）
CreateDirectoryA 新建目录。（CreateDirectoryA）
CreateDirectoryW 新建目录。（CreateDirectoryW）
CreateFile2 创建或打开文件或 I/O 设备。
CreateFile3 创建或打开文件或 I/O 设备。
CreateFileA 创建或打开文件或 I/O 设备。最常用的 I/O 设备如下所示：_file、文件流、目录、物理磁盘、卷、控制台缓冲区、磁带驱动器、通信资源、mailslot 和管道。（ANSI）
CreateFileW 创建或打开文件或 I/O 设备。最常用的 I/O 设备如下所示：_file、文件流、目录、物理磁盘、卷、控制台缓冲区、磁带驱动器、通信资源、mailslot 和管道。（Unicode）
DefineDosDeviceW 定义、重新定义或删除 MS-DOS 设备名称。（DefineDosDeviceW）
DeleteFile2A 删除现有文件。（ANSI）
DeleteFile2W 删除现有文件。（Unicode）
DeleteFileA 删除现有文件。（DeleteFileA）
DeleteFileW 删除现有文件。（DeleteFileW）
DeleteVolumeMountPointW 删除驱动器号或装载的文件夹。（DeleteVolumeMountPointW）
FileTimeToLocalFileTime 将文件时间转换为本地文件时间。
FindClose 关闭由 FindFirstFile、FindFirstFileEx、FindFirstFileNameW、FindFirstFileNameTransactedW、FindFirstFileTransacted、FindFirstStreamTransactedW 或 FindFirstStreamW 函数打开的文件搜索句柄。
FindCloseChangeNotification 停止更改通知处理监视。
FindFirstChangeNotificationA 创建更改通知句柄并设置初始更改通知筛选器条件。（ANSI）
FindFirstChangeNotificationW 创建更改通知句柄并设置初始更改通知筛选器条件。（Unicode）
FindFirstFileA 在目录中搜索与特定名称匹配的名称的文件或子目录（如果使用通配符时为部分名称）。（ANSI）
FindFirstFileExA 使用与指定的名称和属性匹配的文件或子目录搜索目录。（FindFirstFileExA）
FindFirstFileExW 使用与指定的名称和属性匹配的文件或子目录搜索目录。（FindFirstFileExW）
FindFirstFileNameW 创建指向指定文件的所有硬链接的枚举。 FindFirstFileNameW 函数返回枚举的句柄，该句柄可用于对 FindNextFileNameW 函数的后续调用。
FindFirstFileW 在目录中搜索与特定名称匹配的名称的文件或子目录（如果使用通配符时为部分名称）。（Unicode）
FindFirstStreamW 使用指定文件或目录中的：：$DATA 流类型枚举第一个流。
FindFirstVolumeW 检索计算机上的卷的名称。（FindFirstVolumeW）
FindNextChangeNotification 作系统在下次检测到适当的更改时发出更改通知信号的请求处理。
FindNextFileA 继续执行对 FindFirstFile、FindFirstFileEx 或 FindFirstFileTransacted 函数的上一次调用中的文件搜索。（ANSI）
FindNextFileNameW 继续使用成功调用 FindFirstFileNameW 函数返回的句柄枚举指向文件的硬链接。
FindNextFileW 继续执行对 FindFirstFile、FindFirstFileEx 或 FindFirstFileTransacted 函数的上一次调用中的文件搜索。（Unicode）
FindNextStreamW 继续通过对 FindFirstStreamW 函数的上一次调用启动的流搜索。
FindNextVolumeW 继续通过调用 FindFirstVolume 函数启动的卷搜索。（FindNextVolumeW）
FindVolumeClose 关闭指定的卷搜索句柄。
FlushFileBuffers 刷新指定文件的缓冲区，并导致所有缓冲数据写入文件。
GetCompressedFileSizeA 检索用于存储指定文件的实际磁盘存储字节数。（ANSI）
GetCompressedFileSizeW 检索用于存储指定文件的实际磁盘存储字节数。（Unicode）
GetDiskFreeSpaceA 检索有关指定磁盘的信息，包括磁盘上的可用空间量。（ANSI）
GetDiskFreeSpaceExA 检索有关磁盘卷上可用空间量的信息，即总空间量、可用空间总量以及与调用线程关联的用户可用的可用空间总量。（ANSI）
GetDiskFreeSpaceExW 检索有关磁盘卷上可用空间量的信息，即总空间量、可用空间总量以及与调用线程关联的用户可用的可用空间总量。（Unicode）
GetDiskFreeSpaceW 检索有关指定磁盘的信息，包括磁盘上的可用空间量。（Unicode）
GetDiskSpaceInformationA 获取给定根路径处卷的磁盘空间信息。
GetDiskSpaceInformationW 获取给定根路径处卷的磁盘空间信息。
GetDriveTypeA 确定磁盘驱动器是可移动的、固定的、CD-ROM、RAM 磁盘还是网络驱动器。（ANSI）
GetDriveTypeW 确定磁盘驱动器是可移动的、固定的、CD-ROM、RAM 磁盘还是网络驱动器。（Unicode）
GetFileAttributesA 检索指定文件或目录的文件系统属性。（ANSI）
GetFileAttributesExA 检索指定文件或目录的属性。（ANSI）
GetFileAttributesExW 检索指定文件或目录的属性。（Unicode）
GetFileAttributesW 检索指定文件或目录的文件系统属性。（Unicode）
GetFileInformationByHandle 检索指定文件的文件信息。（GetFileInformationByHandle）
GetFileSize 检索指定文件的大小（以字节为单位）。
GetFileSizeEx 检索指定文件的大小。
GetFileTime 检索创建文件或目录、上次访问和上次修改的日期和时间。
GetFileType 检索指定文件的文件类型。
GetFinalPathNameByHandleA 检索指定文件的最终路径。（ANSI）
GetFinalPathNameByHandleW 检索指定文件的最终路径。（Unicode）
GetFullPathNameA 检索指定文件的完整路径和文件名。（ANSI）
GetFullPathNameW 检索指定文件的完整路径和文件名。（Unicode）
GetLogicalDrives 检索表示当前可用磁盘驱动器的位掩码。
GetLogicalDriveStringsW 使用指定系统中有效驱动器的字符串填充缓冲区。（GetLogicalDriveStringsW）
GetLongPathNameA 将指定的路径转换为其长格式。（ANSI）
GetLongPathNameW 将指定的路径转换为其长格式。（Unicode）
GetShortPathNameW 检索指定路径的短路径形式。（GetShortPathNameW）
GetTempFileNameA 为临时文件创建名称。如果生成唯一文件名，则会创建一个空文件，并释放该文件的句柄;否则，仅生成文件名。（GetTempFileNameA）
GetTempFileNameW 为临时文件创建名称。如果生成唯一文件名，则会创建一个空文件，并释放该文件的句柄;否则，仅生成文件名。（GetTempFileNameW）
GetTempPath2A 根据调用进程的特权检索为临时文件指定的目录的路径。（ANSI）
GetTempPath2W 根据调用进程的特权检索为临时文件指定的目录的路径。（Unicode）
GetTempPathA 检索为临时文件指定的目录的路径。（ANSI）
GetTempPathW 检索为临时文件指定的目录的路径。（Unicode）
GetVolumeInformationA 检索与指定根目录关联的文件系统和卷的相关信息。（ANSI）
GetVolumeInformationByHandleW 检索与指定文件关联的文件系统和卷的相关信息。
GetVolumeInformationW 检索与指定根目录关联的文件系统和卷的相关信息。（Unicode）
GetVolumeNameForVolumeMountPointW 检索与指定卷装入点（驱动器号、卷 GUID 路径或已装载文件夹）关联的卷的卷 GUID 路径。（GetVolumeNameForVolumeMountPointW）
GetVolumePathNamesForVolumeNameW 检索指定卷的驱动器号和装载的文件夹路径的列表。（GetVolumePathNamesForVolumeNameW）
GetVolumePathNameW 检索装载指定路径的卷装入点。（GetVolumePathNameW）
LocalFileTimeToFileTime 根据协调世界时（UTC）将本地文件时间转换为文件时间。
LockFile 通过调用进程锁定指定文件以独占访问。
LockFileEx 通过调用进程锁定指定文件以独占访问。此函数可以同步或异步运行，并且可以请求独占锁或共享锁。
QueryDosDeviceW 检索有关 MS-DOS 设备名称的信息。（QueryDosDeviceW）
ReadFile 从指定的文件或输入/输出（I/O）设备读取数据。如果设备支持，则读取发生在文件指针指定的位置。
ReadFileEx 从指定的文件或输入/输出（I/O）设备读取数据。它以异步方式报告其完成状态，在读取完成或取消时调用指定的完成例程，并且调用线程处于可警报等待状态。
ReadFileScatter 从文件读取数据并将其存储在缓冲区数组中。
RemoveDirectory2A 删除现有空目录。（ANSI）
RemoveDirectory2W 删除现有空目录。（Unicode）
RemoveDirectoryA 删除现有空目录。（ANSI）
RemoveDirectoryW 删除现有空目录。（Unicode）
SetEndOfFile 将指定文件的物理文件大小设置为文件指针的当前位置。
SetFileApisToANSI 使文件 I/O 函数使用当前进程的 ANSI 字符集代码页。
SetFileApisToOEM 使进程的文件 I/O 函数使用 OEM 字符集代码页。
SetFileAttributesA 设置文件或目录的属性。（ANSI）
SetFileAttributesW 设置文件或目录的属性。（Unicode）
SetFileInformationByHandle 设置指定文件的文件信息。
SetFileIoOverlappedRange 将虚拟地址范围与指定的文件句柄相关联。
SetFilePointer 移动指定文件的文件指针。（SetFilePointer）
SetFilePointerEx 移动指定文件的文件指针。（SetFilePointerEx）
SetFileTime 设置指定文件或目录的创建、上次访问或修改的日期和时间。
SetFileValidData 设置指定文件的有效数据长度。此函数在非常有限的方案中非常有用。有关详细信息，请参阅“备注”部分。
UnlockFile 解锁打开文件中的区域。
UnlockFileEx 解锁指定文件中的区域。此函数可以同步或异步运行。
WriteFile 将数据写入指定的文件或输入/输出（I/O）设备。
WriteFileEx 将数据写入指定的文件或输入/输出（I/O）设备。它以异步方式报告其完成状态，在完成或取消写入时调用指定的完成例程，并且调用线程处于可警报的等待状态。
WriteFileGather 从缓冲区数组中检索数据，并将数据写入文件。

结构


BY_HANDLE_FILE_INFORMATION 包含 GetFileInformationByHandle 函数检索的信息。
CREATEFILE2_EXTENDED_PARAMETERS 包含 CreateFile2 的可选扩展参数。
CREATEFILE3_EXTENDED_PARAMETERS
DISK_SPACE_INFORMATION DISK_SPACE_INFORMATION结构包含有关特定卷的磁盘空间的信息。
WIN32_FILE_ATTRIBUTE_DATA 包含文件或目录的属性信息。
WIN32_FIND_STREAM_DATA 包含有关 FindFirstStreamW 或 FindNextStreamW 函数找到的流的信息。

枚举


DIRECTORY_FLAGS 定义可用于 CreateDirectory2 函数的标志，以指定应如何创建目录。
STREAM_INFO_LEVELS 定义与 FindFirstStreamW 函数一起使用的值，以指定返回的数据的信息级别。

通过

fileapi.h 标头

功能

结构

枚举

反馈

其他资源