Funzione SHCloneSpecialIDList (shlobj_core.h)

[SHCloneSpecialIDList è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece SHGetSpecialFolderLocation.

Recupera un puntatore alla struttura ITEMIDLIST che specifica una cartella speciale.

Sintassi

PIDLIST_ABSOLUTE SHCloneSpecialIDList(
       HWND hwnd,
  [in] int  csidl,
  [in] BOOL fCreate
);

Parametri

hwnd

Tipo: HWND

Riservato.

[in] csidl

Tipo: int

Valore CSIDL che identifica la cartella di interesse.

[in] fCreate

Tipo: BOOL

Valore di tipo BOOL che indica se la cartella deve essere creata se non esiste già. Se fCreate è TRUE, viene creata la cartella. Se è FALSE, la cartella non viene creata.

Valore restituito

Tipo: PIDLIST_ABSOLUTE

Restituisce un puntatore alla struttura ITEMIDLIST di una cartella speciale specificata da csidl. La funzione crea la cartella se fCreate è TRUE.

Commenti

Al termine, è necessario liberare il puntatore alla cartella clonata con ILFree.

Requisiti