SHGetSpecialFolderLocation-Funktion (shlobj_core.h)
[SHGetSpecialFolderLocation wird nicht unterstützt und kann in Zukunft geändert oder nicht mehr 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 relevanten Ordner identifiziert.
[out] ppidl
Typ: PIDLIST_ABSOLUTE*
Eine PIDL, die den Speicherort des Ordners relativ zum Stammverzeichnis des Namespace (desktop) angibt. Es liegt in der Verantwortung der aufrufenden Anwendung, die zurückgegebene IDList mithilfe von CoTaskMemFree freizugeben.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 (shlobj.h einschließen) |
| Bibliothek | Shell32.lib |
| DLL | Shell32.dll (Version 4.0 oder höher) |
| APIs | ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240) |