Funzione PathFindOnPathA (shlwapi.h)

Cerca un file.

Sintassi

BOOL PathFindOnPathA(
  [in, out]      LPSTR   pszPath,
  [in, optional] PZPCSTR ppszOtherDirs
);

Parametri

[in, out] pszPath

Tipo: LPTSTR

Puntatore a una stringa di lunghezza con terminazione Null MAX_PATH contenente il nome del file in cui eseguire la ricerca. Se la ricerca ha esito positivo, questo parametro viene usato per restituire il nome completo del percorso.

[in, optional] ppszOtherDirs

Tipo: LPCTSTR*

Matrice facoltativa di directory con terminazione Null da cercare per prima. Questo valore può essere NULL.

Valore restituito

Tipo: bool

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

PathFindOnPath cerca il file specificato da pszFile. Se non viene specificata alcuna directory in ppszOtherDirs, tenta di trovare il file cercando directory standard come System32 e le directory specificate nella variabile di ambiente PATH. Per accelerare il processo o abilitare PathFindOnPath per cercare una gamma più ampia di directory, usare il parametro ppszOtherDirs per specificare prima una o più directory da cercare. Se più file hanno il nome specificato da pszFile, PathFindOnPath restituisce la prima istanza trovata.

Fabbisogno