Значення, що повертаються:
Якщо функція успішна, повертається дескриптор пошуку, використовуваний в наступних викликах FindNextFile або FindClose.
При помилковому повертає INVALID_HANDLE_VALUE. Для отримання додаткової інформації про помилку, викликайте GetLastError.
зауваження:
Функція FindFirstFile відкриває десріптор пошуку і повертає інформацію першого запису, з ім'ям, яке відповідає заданим умовам. Наступний список описує деякі особливості пошуку:
- Пошук проводиться тільки по імені файлу, а не з будь-яких його атрибутам, таким як час і тип файлу.
- Пошук допускає довгі і короткі імена файлу.
- Після отримання дескриптора пошуку, використовуйте функцію FindNextFile для пошуку інших файлів, що відповідають тему-же умові.
- Коли дескриптор пошуку більше не потрібен, закрийте його з помощю функції FindClose.
Врахуйте: в деяких випадках, інформація файлових атрибутів на файлових системах NTFS може не бути вірною під час виклику функції FindFirstFile. Для отримання вірних файлових атрибутів файлової системи NTFS, викличте GetFileInformationByHandle.
Врахуйте: починаючи рядок з "\\?" не дає дуступа до кореневої директорії.
Для перевірки діркеторіі, яка не є корнекой, використовуйте шлях до цієї директорії без завершального зворотного слеша. Наприклад, аргумент "C: \ windows" повертає інформацію про директорії "C: \ windows", але не про директорії або файлі в "C: \ windows". Спроба відкриття пошуку з завершальним зворотним слешем, завжди буде невдалою.
Знайте, що хтось може створити або видалити файл з цим ім'ям між часом, поки ви запитуєте результат, і часом, поки ви щось робите з інформацією. Скористайтеся функцією CreateFile з CREATE_NEW (помилка, якщо файл існує), або OPEN_EXISTING (помилка, якщо файл не існує).
Якщо шлях вказує на символьне посилання, буфер WIN32_FIND_FILE містить інформацію про символічне посилання, але не про її цілі.