Функция FindNextFileA (fileapi.h)

Статья
03/05/2024

Продолжает поиск файлов из предыдущего вызова функций FindFirstFile, FindFirstFileEx или FindFirstFileTransacted .

Синтаксис

BOOL FindNextFileA(
  [in]  HANDLE             hFindFile,
  [out] LPWIN32_FIND_DATAA lpFindFileData
);

Параметры

[in] hFindFile

Дескриптор поиска, возвращенный предыдущим вызовом функции FindFirstFile или FindFirstFileEx .

[out] lpFindFileData

Указатель на структуру WIN32_FIND_DATA , которая получает сведения об найденном файле или подкаталоге.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение не равно нулю, а параметр lpFindFileData содержит сведения о следующем найденом файле или каталоге.

Если функция завершается сбоем, возвращаемое значение равно нулю, а содержимое lpFindFileData является неопределенным. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Если функция завершается сбоем из-за отсутствия соответствующих файлов, функция GetLastError возвращает ERROR_NO_MORE_FILES.

Эта функция использует те же фильтры поиска, которые использовались для создания дескриптора поиска, переданного в параметре hFindFile . Дополнительные сведения см. в разделах FindFirstFile и FindFirstFileEx.

Порядок, в котором поиск возвращает файлы, например в алфавитном порядке, не гарантируется и зависит от файловой системы. Если данные необходимо отсортировать, приложение должно выполнить упорядочение после получения всех результатов.

Примечание В редких случаях или в сильно загруженной системе сведения об атрибутах файлов в файловых системах NTFS могут быть не актуальными на момент вызова этой функции. Чтобы получить текущие атрибуты файловой системы NTFS, вызовите функцию GetFileInformationByHandle .

Порядок, в котором эта функция возвращает имена файлов, зависит от типа файловой системы. В файловой системе NTFS и файловых системах CDFS имена обычно возвращаются в алфавитном порядке. В файловых системах FAT имена обычно возвращаются в порядке записи файлов на диск, который может быть в алфавитном порядке. Однако, как было сказано ранее, это поведение не гарантируется.

Если путь указывает на символьную ссылку, буфер WIN32_FIND_DATA содержит сведения о символьной ссылке, а не целевой объект.

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология	Поддерживается
Протокол SMB 3.0	Да
SMB 3.0 Transparent Failover (TFO)	Да
SMB 3.0 с масштабируемыми общими папками (SO)	Да
Файловая система общего тома кластера (CSVFS)	Да
Восстанавливаемая файловая система (ReFS)	Да

Транзакция операций

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

Примеры

Пример см. в разделе Перечисление файлов в каталоге.

Примечание

Заголовок fileapi.h определяет FindNextFile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	fileapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll