SearchPath
DWORD SearchPath(
LPCTSTR lpPath,
LPCTSTR lpFileName,
LPCTSTR lpExtension,
DWORD nBufferLength,
LPTSTR lpBuffer,
LPTSTR *lpFilePart
);
A SearchPath függvény megkeresi a megadott program elérési útvonalát.
Paraméterek
LPCTSTR lpPath
A kiinduló könyvtár útvonala. Ha nem adjuk meg (nil), akkor keresés az alábbi sorrendben történik:
- a hívó alkalmazás könyvtárában keres;
- az aktuális könyvtárban keres;
- a Windows rendszerkönyvtárában keres (SYSTEM, Windows NT/2000/XP esetén SYSTEM32);
- Windows NT/2000/XP esetén a 16-bites Windows rendszerkönyvtárban keres (SYSTEM);
- a Windows könyvtárban keres
- a PATH környezeti változóban megadott könyvtárakban keres.
LPCTSTR lpFileName
A keresett fájl neve az elérési útvonal nélkül.
LPCTSTR lpExtension
Ebben a paraméterben megadhatjuk a fájl kiterjesztését, ha azt az lpFileName paraméterben nem tettük meg. A kiterjesztésnek pont karakterrel kell kezdődnie. Ha nem adjuk meg, akkor a paraméter értéke nil.
DWORD nBufferLength
Annak a buffernek a maximális hossza, amelyben a fájl elérési útvonalát fogjuk megkapni.
LPTSTR lpBuffer
Ebben a bufferben kapjuk meg a fájl elérési útvonalát.
LPTSTR *lpFilePart
A bufferen belül mutat fájlnév első karakterére, vagyis az utolsó „\” karakter utáni karakterre.
Visszatérési érték
Ha az útvonalat megtalálta, akkor a visszatérési érték a bufferbe írt karakterek száma (az útvonal és fájlnév hossza). Előfordulhat, hogy a visszatérési érték nagyobb, mint a megadott bufferhossz, ekkor a bufferbe nem fér bele a teljes útvonal.
Ha a fájl nem találta meg, akkor a visszatérési érték 0.