PathFindOnPathW-Funktion (shlwapi.h)

  • Artikel

Sucht nach einer Datei.

Syntax

BOOL PathFindOnPathW(
  [in, out]      LPWSTR   pszPath,
  [in, optional] PZPCWSTR ppszOtherDirs
);

Parameter

[in, out] pszPath

Typ: LPTSTR

Ein Zeiger auf eine mit NULL endende Zeichenfolge der Länge MAX_PATH, die den Dateinamen enthält, nach dem gesucht werden soll. Wenn die Suche erfolgreich ist, wird dieser Parameter verwendet, um den vollqualifizierten Pfadnamen zurückzugeben.

[in, optional] ppszOtherDirs

Typ: LPCTSTR*

Ein optionales Array mit NULL-Endung von Verzeichnissen, die zuerst durchsucht werden sollen. Dieser Wert kann NULL sein.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, wenn erfolgreich, andernfalls FALSE .

Hinweise

PathFindOnPath sucht nach der von pszFile angegebenen Datei. Wenn in ppszOtherDirs keine Verzeichnisse angegeben sind, wird versucht, die Datei zu finden, indem Standardverzeichnisse wie System32 und die in der PATH-Umgebungsvariablen angegebenen Verzeichnisse durchsucht werden. Um den Prozess zu beschleunigen oder PathFindOnPath zum Durchsuchen eines größeren Bereichs von Verzeichnissen zu aktivieren, verwenden Sie den parameter ppszOtherDirs , um ein oder mehrere Verzeichnisse anzugeben, die zuerst durchsucht werden sollen. Wenn mehrere Dateien den von pszFile angegebenen Namen haben, gibt PathFindOnPath die erste instance zurück, die sie findet.

Hinweis

Der shlwapi.h-Header definiert PathFindOnPath als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 4.71 oder höher)