Функция FindNextFile

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

Синтаксис

BOOL FindNextFile(
  HANDLE hFindFile,                // дескриптор поиска 
  LPWIN32_FIND_DATA lpFindFileData // буфер данных
);

Параметры

hFindFile

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

lpFindFileData

[out] Указатель на структуру WIN32_FIND_DATA, которая получает информацию о найденном файле или подкаталоге. Структура может использоваться в последующих вызовах  FindNextFile, чтобы обратиться к найденному файлу или каталогу.

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

Если функция завершается успешно, возвращаемое значение - не нуль.

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

Замечания

Функция FindNextFile ищет файлы только по имени; она не может использоваться для поисков на основе атрибута. Она ищет и длинные, и короткие имена файла.

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

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

Код примера

Пример, см. в статье Список файлов в каталоге.

Смотри также 

Обзор Управление файламиФункции, используемые в управлении файлами, FindClose, FindFirstFile, FindFirstFileEx, GetFileAttributes, SetFileAttributes, WIN32_FIND_DATA 

Размещение и совместимость FindNextFile

К

Windows XP

Да 

л

Windows 2000 Professional

Да

и

Windows NT Workstation

Да

е

Windows Me

Да

н

Windows 98

Да

т

Windows 95

Да

 
С

Windows Server 2003

Да

е Windows 2000 Server Да
р Windows NT Server Да
в    
е    
р    

Используемая библиотека

Kernel32.lib

Используемая DLL -
 Заголовочный файл  

- объявлено в

Winbase.h

 - включено в

Windows.h

 Unicode

Реализуется как версии Unicode и  ANSI для Windows 2000/XP. А также поддерживается программой Microsoft Layer for Unicode.

 Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz