Valorile returnate:
Dacă funcția este reușită, este returnat descriptorul de căutare utilizat în următoarele solicitări FindNextFile sau FindClose.
La eroare, INVALID_HANDLE_VALUE este returnat. Pentru mai multe informații despre eroare, sunați la GetLastError.
observații:
Funcția FindFirstFile deschide descriptorul de căutare și returnează informații despre primul fișier, cu un nume care corespunde condițiilor specificate. Următoarea listă descrie unele dintre caracteristicile de căutare:
- Căutarea este efectuată numai de numele fișierului și nu de niciunul dintre atributele acestuia, cum ar fi tipul de timp și fișier.
- Căutarea permite nume de fișiere lungi și scurte.
- După ce ați primit descriptorul de căutare, utilizați funcția FindNextFile pentru a găsi restul fișierelor care corespund aceleiași condiții.
- Când descriptorul de căutare nu mai este necesar, închideți-l cu funcția FindClose.
Notă: în unele cazuri, informațiile despre atributele fișierelor pe sistemele de fișiere NTFS pot să nu fie corecte în timpul apelului funcțional FindFirstFile. Pentru a obține atributele fișierelor corecte ale sistemului de fișiere NTFS, sunați la GetFileInformationByHandle.
Notă: începerea liniei cu "\\?" nu oferă acces la directorul rădăcină.
Pentru a testa un dirketory care nu este o rădăcină, utilizați calea către acest director fără întoarcere înapoi. De exemplu, argumentul "C: \ windows" returnează informații despre directorul "C: \ windows", dar nu despre directorul sau fișierul din "C: \ windows". O încercare de a deschide o căutare cu o backslash trailing întotdeauna va eșua.
Să știi că cineva poate crea sau șterge un fișier cu același nume între timp până când cere rezultatul, și atâta timp cât faci ceva cu informațiile. Vă rugăm să folosiți funcția CreateFile cu CREATE_NEW (eroare dacă fișierul există), sau OPEN_EXISTING (eroare dacă fișierul nu există).
Dacă calea indică o legătură simbolică, tamponul WIN32_FIND_FILE conține informații despre legătura simbolică, dar nu despre scopul său.