Функция FindNextFile продолжает поиск файла после предыдущего вызова функции FindFirstFile или FindFirstFileEx.
BOOL FindNextFile (
HANDLE hFindFile ,
LPWIN32_FIND_DATA lpFindFileData
);
Параметры:
| Дескриптор поиска, возвращенняй при предыдущем вызове функции FindFirstFile или FindFirstFileEx. | |
| Адрес структуры WIN32_FIND_DATA, которая получает информацию о найденом файле или директории. Структура может использоваться в последующих вызовах FindNextFile для указания с какого файла продолжать поиск. |
Возвращаемые значения:
Если вызов функции успешен, возвращается ненулевое значение.
При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызывайте GetLastError.
Если файлы не могут быть далее найдены, функция GetLastError возвращает ERROR_NO_MORE_FILES.
При ошибке возвращается ноль. Для получения дополнительной информации об ошибке, вызывайте GetLastError.
Если файлы не могут быть далее найдены, функция GetLastError возвращает ERROR_NO_MORE_FILES.
Замечания:
Функция FindNextFile ищет файлы только по имени, она не может использоваться для поиска по атрибутам. Она ищет и по длинным и по коротким именам файлов. Оригинальная строка поиска, которая была задана при вызове фунции FindFirstFile или FindFirstFileEx, может содержать символы расширяемости (* и ?).
Учтите: в некоторых случаях, информация файловых атрибутов на файловых системах NTFS может не быть верной во время вызова функции FindFirstFile. Для получения верных файловых атрибутов файловой системы NTFS, вызовите GetFileInformationByHandle.
Порядок, в котором эта функция возвращает имена файлов, зависит от типа файловой системы. С файловыми системами NTFS и CDFS, имена возвращаются в алфавитном порядке. С файловой системой FAT, имена возвращаются в том порядке, в котором они были записаны на диск, который может и не быть алфавитным.
Если путь содержит символическую ссылку, буфер WIN32_FIND_FILE содержит информацию о символической ссылке, а не о ее цели.
Учтите: в некоторых случаях, информация файловых атрибутов на файловых системах NTFS может не быть верной во время вызова функции FindFirstFile. Для получения верных файловых атрибутов файловой системы NTFS, вызовите GetFileInformationByHandle.
Порядок, в котором эта функция возвращает имена файлов, зависит от типа файловой системы. С файловыми системами NTFS и CDFS, имена возвращаются в алфавитном порядке. С файловой системой FAT, имена возвращаются в том порядке, в котором они были записаны на диск, который может и не быть алфавитным.
Если путь содержит символическую ссылку, буфер WIN32_FIND_FILE содержит информацию о символической ссылке, а не о ее цели.