Функции управления файлами

Для управления файлами используются следующие функции.

В этом разделе

Функция Описание
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

Следующие функции используются с перенаправителем файловой системы.

Wow64DisableWow64FsRedirection
Wow64EnableWow64FsRedirection
Wow64RevertWow64FsRedirection

Следующие функции используются для распаковки файлов, сжатых алгоритмом Lempel-Ziv.

GetExpandedName
LZClose
LZCopy
LZInit
LZOpenFile
LZRead
LZSeek

Следующие функции обратного вызова используются в файловом вводе-выводе.

CopyProgressRoutine
ExportCallback
FileIOCompletionRoutine
ImportCallback