SHGetSpecialFolderLocation-Funktion (shlobj_core.h)
[SHGetSpecialFolderLocation wird nicht unterstützt und kann in Zukunft geändert oder nicht verfügbar sein. Verwenden Sie stattdessen SHGetFolderLocation.]
Ruft einen Zeiger auf die ITEMIDLIST-Struktur eines speziellen Ordners ab.
Syntax
HRESULT SHGetSpecialFolderLocation(
[in] HWND hwnd,
[in] int csidl,
[out] PIDLIST_ABSOLUTE *ppidl
);
Parameter
[in] hwnd
Typ: HWND
Reserviert.
[in] csidl
Typ: int
Ein CSIDL-Wert , der den Ordner des Interesses identifiziert.
[out] ppidl
Typ: PIDLIST_ABSOLUTE*
Eine PIDL, die den Speicherort des Ordners relativ zum Stamm des Namespaces (dem Desktop) angibt. Es ist die Verantwortung der aufrufenden Anwendung, die zurückgegebene IDList mithilfe von CoTaskMemFree freizugeben.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich verläuft, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shlobj_core.h (enthalten Shlobj.h) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 4.0 oder höher) |
| APIs | ext-ms-win-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240) |