PathFindOnPathW-Funktion (shlwapi.h)

Artikel
11/20/2024

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 beendete Zeichenfolge 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, null-beendetes Array von Verzeichnissen, das zuerst durchsucht werden soll. Dieser Wert kann NULL-sein.

Rückgabewert

Typ: BOOL-

Gibt TRUE zurück, wenn dies erfolgreich ist, oder FALSE andernfalls.

Bemerkungen

PathFindOnPath sucht nach der durch pszFileangegebenen Datei. Wenn in ppszOtherDirskeine Verzeichnisse angegeben werden, wird versucht, die Datei durch Durchsuchen von Standardverzeichnissen wie System32 und den in der PATH-Umgebungsvariablen angegebenen Verzeichnissen zu finden. Um den Prozess zu beschleunigen oder PathFindOnPath- zum Durchsuchen eines größeren Bereichs von Verzeichnissen zu aktivieren, verwenden Sie den ppszOtherDirs Parameter, um zuerst ein oder mehrere Verzeichnisse anzugeben, die durchsucht werden sollen. Wenn mehrere Dateien den durch pszFile-angegebenen Namen aufweisen, gibt PathFindOnPath die erste gefundene Instanz zurück.

Anmerkung

Der Header "shlwapi.h" definiert PathFindOnPath als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über