SHGetPathFromIDListA-Funktion (shlobj_core.h)

  • Artikel

Konvertiert eine Elementbezeichnerliste in einen Dateisystempfad.

Syntax

BOOL SHGetPathFromIDListA(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [out] LPSTR             pszPath
);

Parameter

[in] pidl

Typ: PCIDLIST_ABSOLUTE

Die Adresse einer Elementbezeichnerliste, die einen Datei- oder Verzeichnisspeicherort relativ zum Stamm des Namespaces (desktop) angibt.

[out] pszPath

Typ: LPTSTR

Die Adresse eines Puffers zum Empfangen des Dateisystempfads. Dieser Puffer muss mindestens MAX_PATH Zeichen groß sein.

Rückgabewert

Typ: BOOL

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

Hinweise

Wenn der durch den pidl-Parameter angegebene Speicherort nicht Teil des Dateisystems ist, schlägt diese Funktion fehl.

Wenn der pidl-Parameter eine Verknüpfung angibt, enthält der pszPath den Pfad zur Verknüpfung, nicht zum Ziel der Verknüpfung.

Hinweis

Der shlobj_core.h-Header definiert SHGetPathFromIDList 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

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 4.0 oder höher)
APIs ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393)

Weitere Informationen

SHGetPathFromIDListEx

SHParseDisplayName