SHGetPathFromIDListW-Funktion (shlobj_core.h)
Konvertiert eine Elementbezeichnerliste in einen Dateisystempfad.
Syntax
BOOL SHGetPathFromIDListW(
[in] PCIDLIST_ABSOLUTE pidl,
[out] LPWSTR pszPath
);
Parameter
[in] pidl
Typ: PCIDLIST_ABSOLUTE
Die Adresse einer Elementbezeichnerliste, die einen Datei- oder Verzeichnisspeicherort relativ zum Stamm des Namespace (desktop) angibt.
[out] pszPath
Typ: LPTSTR-
Die Adresse eines Puffers, der den Dateisystempfad empfängt. Dieser Puffer muss mindestens MAX_PATH Zeichen groß sein.
Rückgabewert
Typ: BOOL-
Gibt TRUE- zurück, wenn dies erfolgreich ist; andernfalls FALSE.
Bemerkungen
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 die pszPath- den Pfad zur Verknüpfung, nicht zum Ziel der Verknüpfung.
Anmerkung
Der header shlobj_core.h 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 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 XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h) |
| Library | Shell32.lib |
| DLL- | Shell32.dll (Version 4.0 oder höher) |
| API-Satz | ext-ms-win-shell-shell32-l1-2-2 (eingeführt in Windows 10, Version 10.0.14393) |