SHGetSpecialFolderLocation-Funktion (shlobj_core.h)

  • Artikel

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

Weitere Informationen

SHGetSpecialFolderPath