PathResolve-Funktion (shlobj_core.h)

  • Artikel

[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)

Weitere Informationen

PathFindOnPath