Fonction SHCloneSpecialIDList (shlobj_core.h)

Article
03/04/2024

[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

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 5.0 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-2 (introduit dans Windows 10, version 10.0.14393)

Partager via