Winapi funkció referencia
Visszatérési értékek:
Ha a függvény sikeres, a későbbi FindNextFile vagy FindClose hívásokban használt keresési leíró visszaadható.
Hiba esetén INVALID_HANDLE_VALUE kerül visszaadásra. A hibáról további információkat a GetLastError.
megjegyzések:
A FindFirstFile funkció megnyitja a keresési leírót, és az első fájlra vonatkozó információkat adja vissza, a megadott feltételeknek megfelelő névvel. Az alábbi lista néhány keresési funkciót ismertet:
- A keresést csak a fájlnév, és nem annak egyik attribútuma, például az idő és a fájltípus hajtja végre.
- A keresés lehetővé teszi a hosszú és rövid fájlneveket.
- Miután megkapta a keresési leírót, használja a FindNextFile függvényt, hogy megtalálja az azonos feltételeknek megfelelő fájlokat.
- Ha a keresési leíróra már nincs szükség, zárja be a FindClose funkcióval.
Megjegyzés: egyes esetekben az NTFS fájlrendszerek fájlinformációinformációja nem megfelelő a FindFirstFile függvényhívás során. Az NTFS fájlrendszer helyes fájltulajdonságainak megszerzéséhez hívja fel a GetFileInformationByHandle nevet.
Megjegyzés: a sor elindítása "\\?" nem ad hozzáférést a gyökérkönyvtárhoz.
Ha nem egy gyökércéget próbál meg tesztelni, használja ezt a könyvtár elérési útját anélkül, hogy visszalépne. Például a "C: \ windows" argumentum visszaadja a "C: \ windows" könyvtár adatait, de nem a "C: \ windows" könyvtárról vagy fájlról. Az a kísérlet, hogy a keresést egy visszalépéses visszalépéssel nyissuk meg, mindig sikertelen lesz.
Legyen tudatában annak, hogy valaki létrehozhat vagy törölhet egy fájlt ezzel a névvel az idő kérése és az idő alatt, miközben valamit csinál az információval. Használja a CreateFile függvényt CREATE_NEW (hiba esetén a fájl létezik) vagy OPEN_EXISTING (hiba, ha a fájl nem létezik).
Ha az útvonal egy szimbolikus hivatkozásra mutat, a WIN32_FIND_FILE puffer információt tartalmaz a szimbolikus linkről, de nem a célról.