Fonction SHCloneSpecialIDList (shlobj_core.h)

[SHCloneSpecialIDList est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt SHGetSpecialFolderLocation.]

Récupère un pointeur vers la structure ITEMIDLIST qui spécifie un dossier spécial.

Syntaxe

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

Paramètres

hwnd

Type : HWND

Réservé.

[in] csidl

Type : int

Valeur CSIDL qui identifie le dossier d’intérêt.

[in] fCreate

Type : BOOL

Valeur de type BOOL qui indique si le dossier doit être créé s’il n’existe pas déjà. Si fCreate a la valeur TRUE, le dossier est créé. S’il a la valeur FALSE, le dossier n’est pas créé.

Valeur retournée

Type : PIDLIST_ABSOLUTE

Retourne un pointeur vers la structure ITEMIDLIST d’un dossier spécial spécifié par csidl. La fonction crée le dossier si fCreate a la valeur TRUE.

Remarques

Lorsque vous avez terminé, vous devez libérer le pointeur vers le dossier cloné avec ILFree.

Configuration requise