Funzione SHGetSpecialFolderLocation (shlobj_core.h)

  • Articolo

[SHGetSpecialFolderLocation non è supportato e potrebbe essere modificato o non disponibile in futuro. Usare invece SHGetFolderLocation.]

Recupera un puntatore alla struttura ITEMIDLIST di una cartella speciale.

Sintassi

HRESULT SHGetSpecialFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Parametri

[in] hwnd

Tipo: HWND

Riservato.

[in] csidl

Tipo: int

Valore CSIDL che identifica la cartella di interesse.

[out] ppidl

Tipo: PIDLIST_ABSOLUTE*

PiDL che specifica il percorso della cartella rispetto alla radice dello spazio dei nomi (desktop). È responsabilità dell'applicazione chiamante liberare l'IDList restituito usando CoTaskMemFree.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h (include Shlobj.h)
Libreria Shell32.lib
DLL Shell32.dll (versione 4.0 o successiva)
Set di API ext-ms-win-shell-shell32-l1-2-1 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

SHGetSpecialFolderPath