Функция 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. |
|
| Замечания по платформе |
Не имеется |
|