PathFindOnPathA-Funktion (shlwapi.h)
Sucht nach einer Datei.
Syntax
BOOL PathFindOnPathA(
[in, out] LPSTR pszPath,
[in, optional] PZPCSTR ppszOtherDirs
);
Parameter
[in, out] pszPath
Typ: LPTSTR
Ein Zeiger auf eine mit NULL beendete 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, NULL-beendetes Array von Verzeichnissen, die zuerst durchsucht werden sollen. Dieser Wert kann NULL sein.
Rückgabewert
Typ: BOOL
Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder 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 für die Suche in einem größeren Bereich von Verzeichnissen zu aktivieren, verwenden Sie den ppszOtherDirs-Parameter , um ein oder mehrere Verzeichnisse anzugeben, die zuerst durchsucht werden sollen. Wenn mehrere Dateien den von pszFile angegebenen Namen haben, gibt PathFindOnPath den ersten instance zurück, den 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 nicht codierungsneutralem Code 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) |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für