文件管理功能
以下函数用于管理文件。
在本节中
| 函数 | 说明 |
|---|---|
| AddUsersToEncryptedFile |
将用户密钥添加到指定的加密文件。 |
| AreFileApisANSI |
确定文件 I/O 函数是使用 ANSI 还是 OEM 字符集代码页。 |
| CancelIo |
取消所有挂起的输入和输出 (由指定文件的调用线程发出的 I/O) 操作。 |
| CancelIoEx |
标记指定文件句柄的任何未完成的 I/O 操作。 函数仅取消当前进程中的 I/O 操作，而不管哪个线程创建了 I/O 操作。 |
| CancelSynchronousIo |
将指定线程发出的挂起同步 I/O 操作标记为已取消。 |
| CheckNameLegalDOS8Dot3 |
确定指定名称是否可用于在 FAT 文件系统上创建文件。 |
| CloseEncryptedFileRaw |
在备份或还原操作后关闭加密的文件，并释放关联的系统资源。 |
| CopyFile |
将现有文件复制到新文件。 |
| CopyFile2 |
将现有文件复制到新文件，并通过回调函数通知应用程序其进度。 |
| PCOPYFILE2_PROGRESS_ROUTINE |
与 CopyFile2 函数一起使用的应用程序定义的回调函数。 |
| CopyFileEx |
将现有文件复制到新文件，并通过回调函数通知应用程序其进度。 |
| CopyFileTransacted |
将现有文件作为事务处理操作复制到新文件，并通过回调函数通知应用程序其进度。 |
| CopyProgressRoutine |
与 CopyFileEx、 MoveFileTransacted 和 MoveFileWithProgress 函数一起使用的应用程序定义的回调函数。 |
| CreateFile |
创建或打开文件或 I/O 设备。 最常用的 I/O 设备如下：文件、文件流、目录、物理磁盘、卷、控制台缓冲区、磁带驱动器、通信资源、mailslot 和管道。 |
| CreateFile2 |
创建或打开文件。 |
| CreateFileTransacted |
创建或打开文件、文件流或目录作为事务处理操作。 |
| CreateHardLink |
在现有文件和新文件之间建立硬链接。 |
| CreateHardLinkTransacted |
在现有文件与新文件之间建立硬链接，作为事务处理操作。 |
| CreateIoCompletionPort |
创建一个输入/输出 (I/O) 完成端口，并将其与指定的文件句柄相关联，或创建尚未与文件句柄关联的 I/O 完成端口，允许稍后关联。 |
| CreateSymbolicLink |
创建符号链接。 |
| CreateSymbolicLinkTransacted |
创建符号链接作为事务处理操作。 |
| DecryptFile |
解密加密的文件或目录。 |
| DeleteFile |
删除现有文件。 |
| DeleteFileTransacted |
将现有文件作为事务处理操作删除。 |
| DuplicateEncryptionInfoFile |
将 EFS 元数据从一个文件或目录复制到另一个文件或目录。 |
| EncryptFile |
加密文件或目录。 |
| EncryptionDisable |
禁用或启用对指定目录及其中的文件的加密。 |
| ExportCallback |
与 ReadEncryptedFileRaw 一起使用的应用程序定义的回调函数。 |
| FileEncryptionStatus |
检索指定文件的加密状态。 |
| FileIOCompletionRoutine |
与 ReadFileEx 和 WriteFileEx 函数一起使用的应用程序定义的回调函数。 当异步输入和输出 (I/O) 操作完成或取消且调用线程处于可警报状态时，将调用它。 |
| FindClose |
关闭由 FindFirstFile、FindFirstFileEx、FindFirstFileNameW、FindFirstFileNameTransactedW、FindFirstFileTransacted、FindFirstStreamTransactedW 或 FindFirstStreamW 函数打开的文件搜索句柄。 |
| FindFirstFile |
如果在) 使用通配符，则搜索目录中具有与特定名称 (或部分名称匹配的名称的文件或子目录。 |
| FindFirstFileEx |
在目录中搜索具有与指定属性匹配的名称和属性的文件或子目录。 |
| FindFirstFileNameTransactedW |
以事务处理操作的形式创建指向指定文件的所有硬链接的枚举。 函数返回枚举的句柄，该句柄可用于 对 FindNextFileNameW 函数的后续调用。 |
| FindFirstFileNameW |
创建指向指定文件的所有硬链接的枚举。 FindFirstFileNameW 函数返回枚举的句柄，该句柄可用于对 FindNextFileNameW 函数的后续调用。 |
| FindFirstFileTransacted |
在目录中搜索具有与特定名称匹配的名称的文件或子目录，作为事务处理操作。 |
| FindFirstStreamTransactedW |
枚举指定文件或目录中的第一个流作为事务处理操作。 |
| FindFirstStreamW |
枚举指定文件或目录中具有 ：：$DATA 流类型的第一个流。 |
| FindNextFile |
从上一次调用 FindFirstFile、 FindFirstFileEx 或 FindFirstFileTransacted 函数继续文件搜索。 |
| FindNextFileNameW |
继续使用成功调用 FindFirstFileNameW 函数返回的句柄枚举指向文件的硬链接。 |
| FindNextStreamW |
继续通过上一次调用 FindFirstStreamW 函数启动的流搜索。 |
| FlushFileBuffers |
刷新指定文件的缓冲区，并使所有缓冲的数据都写入文件。 |
| FreeEncryptionCertificateHashList |
释放证书哈希列表。 |
| GetBinaryType |
确定文件是否为可执行 (.exe) 文件，如果是，则由哪个子系统运行可执行文件。 |
| GetCompressedFileSize |
检索用于存储指定文件的磁盘存储的实际字节数。 |
| GetCompressedFileSizeTransacted |
检索用于将指定文件存储为事务操作的实际磁盘存储字节数。 |
| GetExpandedName |
检索压缩文件的原始名称（如果该文件是由Lempel-Ziv算法压缩的）。 |
| GetFileAttributes |
检索指定文件或目录的文件系统属性。 |
| GetFileAttributesEx |
检索指定文件或目录的属性。 |
| GetFileAttributesTransacted |
检索指定文件或目录的文件系统属性作为事务处理操作。 |
| GetFileBandwidthReservation |
检索指定文件所在的卷的带宽预留属性。 |
| GetFileInformationByHandle |
检索指定文件的文件信息。 |
| GetFileInformationByHandleEx |
检索指定文件的文件信息。 |
| GetFileSize |
检索指定文件的大小（以字节为单位）。 |
| GetFileSizeEx |
检索指定文件的大小。 |
| GetFileType |
检索指定文件的文件类型。 |
| GetFinalPathNameByHandle |
检索指定文件的最终路径。 |
| GetFullPathName |
检索指定文件的完整路径和文件名。 |
| GetFullPathNameTransacted |
检索指定文件的完整路径和文件名作为事务处理操作。 |
| GetLongPathName |
将指定的路径转换为其长格式。 |
| GetLongPathNameTransacted |
将指定的路径转换为其长格式作为事务处理操作。 |
| GetQueuedCompletionStatus |
尝试从指定的 I/O 完成端口取消 I/O 完成数据包的排队。 |
| GetQueuedCompletionStatusEx |
同时检索多个完成端口条目。 |
| GetShortPathName |
检索指定路径的短路径形式。 |
| GetTempFileName |
创建临时文件的名称。 如果生成了唯一的文件名，则会创建一个空文件，并释放它的句柄;否则，仅生成文件名。 |
| GetTempPath |
检索为临时文件指定的目录的路径。 |
| ImportCallback |
与 WriteEncryptedFileRaw 一起使用的应用程序定义的回调函数。 系统调用 ImportCallback 一次或多次，每次都检索备份文件的一部分数据。 |
| LockFile |
锁定指定的文件以供调用进程进行独占访问。 |
| LockFileEx |
锁定指定的文件以供调用进程进行独占访问。 此函数可以同步或异步运行，并且可以请求独占锁或共享锁。 |
| LZClose |
关闭使用 LZOpenFile 函数打开的文件。 |
| LZCopy |
将源文件复制到目标文件。 |
| LZInit |
为解压缩文件所需的内部数据结构分配内存，然后创建并初始化它们。 |
| LZOpenFile |
创建、打开、重新打开或删除指定的文件。 |
| LZRead |
从文件中读取最多 () 指定字节数，并将其复制到缓冲区中。 |
| LZSeek |
将文件指针从起始位置移出指定的字节数。 |
| MoveFile |
移动现有文件或目录，包括其子级。 |
| MoveFileEx |
使用各种移动选项移动现有文件或目录，包括其子级。 |
| MoveFileTransacted |
将现有文件或目录（包括其子级）作为事务处理操作移动。 |
| MoveFileWithProgress |
移动文件或目录，包括其子级。 可以提供接收进度通知的回调函数。 |
| OpenEncryptedFileRaw |
打开加密文件，以便备份 (导出) 或还原 (导入) 该文件。 |
| OpenFile |
创建、打开、重新打开或删除文件。 |
| OpenFileById |
打开与指定标识符匹配的文件。 |
| PostQueuedCompletionStatus |
将 I/O 完成数据包发布到 I/O 完成端口。 |
| QueryRecoveryAgentsOnEncryptedFile |
检索指定文件的恢复代理列表。 |
| QueryUsersOnEncryptedFile |
检索指定文件的用户列表。 |
| ReadEncryptedFileRaw |
备份 (导出) 加密文件。 |
| ReadFile |
从指定的文件或输入/输出 (I/O) 设备读取数据。 读取发生在文件指针指定的位置（如果设备支持）。 |
| ReadFileEx |
从指定的文件或输入/输出 (I/O) 设备读取数据。 它以异步方式报告其完成状态，在读取完成或取消且调用线程处于可警报等待状态时调用指定的完成例程。 |
| ReadFileScatter |
从文件读取数据并将其存储在缓冲区数组中。 |
| RemoveUsersFromEncryptedFile |
从指定的文件中删除指定的证书哈希。 |
| ReOpenFile |
使用不同的访问权限、共享模式和标志重新打开指定的文件系统对象。 |
| ReplaceFile |
将一个文件替换为另一个文件，并可以选择创建原始文件的备份副本。 |
| SearchPath |
在指定路径搜索指定文件。 |
| SetEndOfFile |
将指定文件的物理文件大小设置为文件指针的当前位置。 |
| SetFileApisToANSI |
使文件 I/O 函数对当前进程使用 ANSI 字符集代码页。 |
| SetFileApisToOEM |
使进程的文件 I/O 函数使用 OEM 字符集代码页。 |
| SetFileAttributes |
设置文件或目录的属性。 |
| SetFileAttributesTransacted |
将文件或目录的属性设置为事务处理操作。 |
| SetFileBandwidthReservation |
请求保留指定文件流的带宽。 预留指定为指定文件句柄上的 I/O 请求的字节数（以毫秒为单位）。 |
| SetFileCompletionNotificationModes |
设置文件句柄的通知模式，以便指定完成通知对指定文件的工作方式。 |
| SetFileInformationByHandle |
设置指定文件的文件信息。 |
| SetFileIoOverlappedRange |
将虚拟地址范围与指定的文件句柄相关联。 |
| SetFilePointer |
移动指定文件的文件指针。 |
| SetFilePointerEx |
移动指定文件的文件指针。 |
| SetFileShortName |
设置指定文件的短名称。 |
| SetFileValidData |
设置指定文件的有效数据长度。 此函数在非常有限的方案中很有用。 有关详细信息，请参见“备注”部分。 |
| SetSearchPathMode |
设置 SearchPath 函数在查找文件时使用的按进程模式。 |
| SetUserFileEncryptionKey |
将用户的当前密钥设置为指定的证书。 |
| UnlockFile |
解锁打开文件中的区域。 |
| UnlockFileEx |
解锁指定文件中的区域。 此函数可以同步或异步运行。 |
| WofEnumEntries |
枚举指定卷的指定提供程序中的所有数据源。 |
| WofEnumEntryProc |
针对每个数据源调用的回调函数，以响应对 WofEnumEntries 的调用。 |
| WofEnumFilesProc |
针对外部数据源（如 WIM 文件）支持的每个文件调用的回调函数。 |
| WofFileEnumFiles |
枚举在指定卷上使用指定压缩算法压缩的所有文件。 |
| WofGetDriverVersion |
用于查询用于支持特定提供程序的驱动程序版本。 |
| WofIsExternalFile |
用于确定文件是由物理文件支持还是由系统数据提供程序提供支持，并选择性地指示哪个提供程序或有关该文件的其他数据。 |
| WofSetFileDataLocation |
用于将文件从物理文件更改为由系统数据提供程序提供支持的文件。 |
| WofShouldCompressBinaries |
指示是否应对特定卷使用压缩，如果是，则应使用哪种压缩算法。 |
| WofWimAddEntry |
将单个 WIM 数据源添加到卷，以便可以在存储在 WIM 中的卷上创建文件。 |
| WofWimEnumFiles |
枚举由指定卷上的指定 WIM 数据源支持的所有文件。 |
| WofWimRemoveEntry |
从卷上的备份文件中删除单个 WIM 数据源。 |
| WofWimSuspendEntry |
在重新装载卷或使用 WofWimUpdateEntry 更新数据源之前，暂时删除卷上的文件备份的 WIM 数据源。 |
| WofWimUpdateEntry |
汇报 WIM 条目以指向不同的 WIM 文件位置。 |
| Wow64DisableWow64FsRedirection |
禁用调用线程的文件系统重定向。 默认情况下启用文件系统重定向。 |
| Wow64EnableWow64FsRedirection |
启用或禁用调用线程的文件系统重定向。 |
| Wow64RevertWow64FsRedirection |
还原调用线程的文件系统重定向。 |
| WriteEncryptedFileRaw |
还原 (导入) 加密文件。 |
| WriteFile |
将数据写入指定的文件或输入/输出 (I/O) 设备。 |
| WriteFileEx |
将数据写入指定的文件或输入/输出 (I/O) 设备。 它以异步方式报告其完成状态，在写入完成或取消且调用线程处于可警报等待状态时调用指定的完成例程。 |
| WriteFileGather |
从缓冲区数组检索数据，并将数据写入文件。 |
以下函数用于文件 I/O。
CancelIo
CancelIoEx
CancelSynchronousIo
CreateIoCompletionPort
FlushFileBuffers
GetQueuedCompletionStatus
GetQueuedCompletionStatusEx
LockFile
LockFileEx
PostQueuedCompletionStatus
ReadFile
ReadFileEx
ReadFileScatter
SetEndOfFile
SetFileCompletionNotificationModes
SetFileIoOverlappedRange
SetFilePointer
SetFilePointerEx
UnlockFile
UnlockFileEx
WriteFile
WriteFileEx
WriteFileGather
以下函数用于加密文件系统。
AddUsersToEncryptedFile
CloseEncryptedFileRaw
DecryptFile
DuplicateEncryptionInfoFile
EncryptFile
EncryptionDisable
FileEncryptionStatus
FreeEncryptionCertificateHashList
OpenEncryptedFileRaw
QueryRecoveryAgentsOnEncryptedFile
QueryUsersOnEncryptedFile
ReadEncryptedFileRaw
RemoveUsersFromEncryptedFile
SetUserFileEncryptionKey
WriteEncryptedFileRaw
以下函数与 文件系统重定向器一起使用。
以下函数用于解压缩由Lempel-Ziv算法压缩的文件。
以下回调函数用于文件 I/O。
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈