Функции управления файлами
Для управления файлами используются следующие функции.
В этом разделе
| Функция | Описание |
|---|---|
| AddUsersToEncryptedFile |
Добавляет пользовательские ключи в указанный зашифрованный файл. |
| AreFileApisANSI |
Определяет, используют ли функции файлового ввода-вывода кодовую страницу кодировки ANSI или OEM. |
| CancelIo |
Отменяет все ожидающие операции ввода-вывода, которые выдаются вызывающим потоком для указанного файла. |
| CancelIoEx |
Помечает все невыполненные операции ввода-вывода для указанного дескриптора файла. Функция отменяет операции ввода-вывода только в текущем процессе, независимо от того, какой поток создал операцию ввода-вывода. |
| CancelSynchronousIo |
Помечает ожидающие синхронные операции ввода-вывода, выданные указанным потоком, как отмененные. |
| CheckNameLegalDOS8Dot3 |
Определяет, можно ли использовать указанное имя для создания файла в файловой системе FAT. |
| CloseEncryptedFileRaw |
Закрывает зашифрованный файл после операции резервного копирования или восстановления и освобождает связанные системные ресурсы. |
| CopyFile |
Копирует существующий файл в новый файл. |
| CopyFile2 |
Копирует существующий файл в новый файл, уведомляя приложение о ходе выполнения с помощью функции обратного вызова. |
| PCOPYFILE2_PROGRESS_ROUTINE |
Определяемая приложением функция обратного вызова, используемая с функцией CopyFile2 . |
| CopyFileEx |
Копирует существующий файл в новый файл, уведомляя приложение о ходе выполнения с помощью функции обратного вызова. |
| CopyFileTransacted |
Копирует существующий файл в новый файл в качестве транзакции операции, уведомляя приложение о ходе выполнения с помощью функции обратного вызова. |
| CopyProgressRoutine |
Определяемая приложением функция обратного вызова, используемая с функциями CopyFileEx, MoveFileTransacted и MoveFileWithProgress . |
| CreateFile |
Создает или открывает файл или устройство ввода-вывода. Наиболее часто используемые устройства ввода-вывода: файл, файловый поток, каталог, физический диск, том, буфер консоли, ленточный накопитель, ресурс связи, почтовый слопот и канал. |
| CreateFile2 |
Создает или открывает файл. |
| CreateFileTransacted |
Создает или открывает файл, файловый поток или каталог в виде транзакции. |
| CreateHardLink |
Устанавливает жесткую связь между существующим и новым файлом. |
| CreateHardLinkTransacted |
Устанавливает жесткую связь между существующим и новым файлом в виде транзакции. |
| CreateIoCompletionPort |
Создает порт завершения ввода-вывода и связывает его с указанным дескриптором файла или создает порт завершения ввода-вывода, который еще не связан с дескриптором файла, что позволяет связаться позже. |
| 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 |
Пытается вывести пакет завершения ввода-вывода из указанного порта завершения ввода-вывода. |
| GetQueuedCompletionStatusEx |
Извлекает несколько записей портов завершения одновременно. |
| GetShortPathName |
Извлекает форму короткого пути указанного пути. |
| GetTempFileName |
Создает имя для временного файла. Если создается уникальное имя файла, создается пустой файл и дескриптор для него освобождается; В противном случае создается только имя файла. |
| GetTempPath |
Извлекает путь к каталогу, назначенному для временных файлов. |
| ImportCallback |
Определяемая приложением функция обратного вызова, используемая с WriteEncryptedFileRaw. Система вызывает ImportCallback один или несколько раз, каждый раз, чтобы получить часть данных файла резервной копии. |
| LockFile |
Блокирует указанный файл для монопольного доступа вызывающим процессом. |
| LockFileEx |
Блокирует указанный файл для монопольного доступа вызывающим процессом. Эта функция может работать синхронно или асинхронно и запрашивать монопольную или общую блокировку. |
| LZClose |
Закрывает файл, открытый с помощью функции LZOpenFile . |
| LZCopy |
Копирует исходный файл в целевой файл. |
| LZInit |
Выделяет память для внутренних структур данных, необходимых для распаковки файлов, а затем создает и инициализирует их. |
| LZOpenFile |
Создает, открывает, повторно открывает или удаляет указанный файл. |
| LZRead |
Считывает (максимум) указанное количество байтов из файла и копирует их в буфер. |
| LZSeek |
Перемещает указатель файла на указанное количество байтов из начальной позиции. |
| MoveFile |
Перемещает существующий файл или каталог, включая его дочерние элементы. |
| MoveFileEx |
Перемещает существующий файл или каталог, включая его дочерние элементы, с различными параметрами перемещения. |
| MoveFileTransacted |
Перемещает существующий файл или каталог, включая его дочерние элементы, в качестве транзакции операции. |
| MoveFileWithProgress |
Перемещает файл или каталог, включая его дочерние элементы. Вы можете предоставить функцию обратного вызова, которая получает уведомления о ходе выполнения. |
| OpenEncryptedFileRaw |
Открывает зашифрованный файл для резервного копирования (экспорта) или восстановления (импорта) файла. |
| OpenFile |
Создает, открывает, повторно открывает или удаляет файл. |
| OpenFileById |
Открывает файл, соответствующий указанному идентификатору. |
| PostQueuedCompletionStatus |
Отправляет пакет завершения ввода-вывода на порт завершения ввода-вывода. |
| QueryRecoveryAgentsOnEncryptedFile |
Извлекает список агентов восстановления для указанного файла. |
| QueryUsersOnEncryptedFile |
Извлекает список пользователей для указанного файла. |
| ReadEncryptedFileRaw |
Выполняет резервное копирование (экспорт) зашифрованных файлов. |
| ReadFile |
Считывает данные из указанного файла или устройства ввода-вывода. Операции чтения выполняются в позиции, указанной указателем файла, если устройство поддерживает. |
| ReadFileEx |
Считывает данные из указанного файла или устройства ввода-вывода. Он асинхронно сообщает о состоянии завершения, вызывая указанную подпрограмму завершения, когда чтение завершено или отменено, а вызывающий поток находится в состоянии ожидания с возможностью оповещения. |
| ReadFileScatter |
Считывает данные из файла и сохраняет их в массиве буферов. |
| RemoveUsersFromEncryptedFile |
Удаляет указанные хэши сертификатов из указанного файла. |
| ReOpenFile |
Повторно открывает указанный объект файловой системы с разными правами доступа, режимом общего доступа и флагами. |
| ReplaceFile |
Заменяет один файл другим с возможностью создания резервной копии исходного файла. |
| SearchPath |
Выполняет поиск указанного файла по указанному пути. |
| SetEndOfFile |
Задает размер физического файла для указанного файла в соответствии с текущей позицией указателя файла. |
| SetFileApisToANSI |
Заставляет функции файлового ввода-вывода использовать кодовую страницу кодировки ANSI для текущего процесса. |
| SetFileApisToOEM |
Заставляет функции файлового ввода-вывода для процесса использовать кодовую страницу кодировки OEM. |
| SetFileAttributes |
Задает атрибуты для файла или каталога. |
| SetFileAttributesTransacted |
Задает атрибуты для файла или каталога в виде транзакций. |
| SetFileBandwidthReservation |
Запрашивает резервирование пропускной способности для указанного потока файлов. Резервирование указывается в виде количества байтов в миллисекундах для запросов ввода-вывода для указанного дескриптора файла. |
| 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 |
Временно удаляет источник данных WIM из резервного копирования файлов на томе, пока том не будет повторно подключен или источник данных не будет обновлен с помощью WofWimUpdateEntry. |
| WofWimUpdateEntry |
Обновления запись WIM, указывая на другое расположение WIM-файла. |
| Wow64DisableWow64FsRedirection |
Отключает перенаправление файловой системы для вызывающего потока. Перенаправление файловой системы включено по умолчанию. |
| Wow64EnableWow64FsRedirection |
Включает или отключает перенаправление файловой системы для вызывающего потока. |
| Wow64RevertWow64FsRedirection |
Восстанавливает перенаправление файловой системы для вызывающего потока. |
| WriteEncryptedFileRaw |
Восстанавливает (импорт) зашифрованные файлы. |
| WriteFile |
Записывает данные в указанный файл или на устройство ввода-вывода. |
| WriteFileEx |
Записывает данные в указанный файл или на устройство ввода-вывода. Он асинхронно сообщает о своем состоянии завершения, вызывая указанную подпрограмму завершения, когда запись завершена или отменена, а вызывающий поток находится в состоянии ожидания с оповещением. |
| WriteFileGather |
Извлекает данные из массива буферов и записывает данные в файл. |
С файлом ввода-вывода используются следующие функции.
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.
Следующие функции обратного вызова используются в файловом вводе-выводе.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по