Fonction ILFree (shlobj_core.h)

Libère une structure ITEMIDLIST allouée par l’interpréteur de commandes.

Syntaxe

void ILFree(
  [in] PIDLIST_RELATIVE pidl
);

Paramètres

[in] pidl

Type : PIDLIST_RELATIVE

Pointeur vers la structure ITEMIDLIST à libérer. Ce paramètre peut être NULL.

Valeur de retour

None

Remarques

ILFree est souvent utilisé avec les structures ITEMIDLIST allouées par l’une des autres fonctions IL, mais il peut être utilisé pour libérer toute structure renvoyée par l’interpréteur de commandes, par exemple, la structure ITEMIDLIST retournée par SHBrowseForFolder ou utilisée dans un appel à SHGetFolderLocation.

Note Lorsque vous utilisez Windows 2000 ou version ultérieure, utilisez CoTaskMemFree plutôt que ILFree. Les structures ITEMIDLIST sont toujours allouées avec l’allocateur de tâches COM (Component Object Model) sur ces plateformes.
 

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)

Voir aussi

ILAppendID

ILClone

ILCloneFirst

ILCombine