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

Weitere Informationen

SHGetSpecialFolderPath