PathResolve-Funktion (shlobj_core.h)
[PathResolve ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Konvertiert einen relativen oder nicht qualifizierten Pfadnamen in einen vollqualifizierten Pfadnamen.
Syntax
int PathResolve(
[in, out] PWSTR pszPath,
[in, optional] PZPCWSTR dirs,
UINT fFlags
);
Parameter
[in, out] pszPath
Typ: PWSTR
Eine Unicode-Zeichenfolge mit NULL-Beendigung, die den zu auflösenden Pfad enthält. Wenn die Funktion zurückgibt, enthält die Zeichenfolge den entsprechenden vollqualifizierten Pfad. Dieser Puffer sollte mindestens MAX_PATH Zeichen lang sein.
[in, optional] dirs
Typ: PZPCWSTR
Ein Zeiger auf ein optionales Null-beendetes Array von Verzeichnissen, die zuerst durchsucht werden sollen, falls der Pfad nicht aus pszPath aufgelöst werden kann. Dieser Wert kann NULL sein.
fFlags
Typ: UINT
Flags, die angeben, wie die Funktion funktioniert.
PRF_VERIFYEXISTS
Gibt TRUE zurück, wenn die Existenz der Datei überprüft wurde. andernfalls FALSE.
PRF_TRYPROGRAMEXTENSIONS
Suchen Sie nach dem angegebenen Pfad mit den folgenden Erweiterungen: .pif, .com, .bat, .cmd, .lnk und .exe.
PRF_FIRSTDIRDEF
Suchen Sie zuerst in dem Verzeichnis oder den Verzeichnissen, die durch Dirs angegeben sind.
PRF_DONTFINDLNK
Ignorieren Sie .lnk Dateien.
PRF_REQUIREABSOLUTE
Erfordert einen absoluten (vollständigen) Pfad.
Rückgabewert
Typ: int
Gibt TRUE zurück, es sei denn, PRF_VERIFYEXISTS ist festgelegt. Wenn dieses Flag festgelegt ist, gibt die Funktion TRUE zurück, wenn die Datei als vorhanden überprüft wird, andernfalls FALSE . Außerdem wird ein ERROR_FILE_NOT_FOUND Fehlercode festgelegt, den Sie abrufen können, indem Sie GetLastError aufrufen.
Hinweise
Ein FALSE-Rückgabewert bedeutet nicht unbedingt, dass die Datei nicht vorhanden ist. Dies kann bedeuten, dass die Funktion die Datei aus den angegebenen Informationen einfach nicht finden kann.
Wenn PathResolve den in pszPath angegebenen Pfad nicht auflösen kann, ruft es PathFindOnPath mit pszPath und dirs als Parameter auf.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlobj_core.h (einschließlich Shlobj.h) |
Bibliothek | Shell32.lib |
DLL | Shell32.dll (Version 5.0 oder höher) |
APIs | ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393) |