Función ILFree (shlobj_core.h)

2024-03-02

Libera una estructura ITEMIDLIST asignada por el Shell.

Sintaxis

void ILFree(
  [in] PIDLIST_RELATIVE pidl
);

Parámetros

[in] pidl

Tipo: PIDLIST_RELATIVE

Puntero a la estructura ITEMIDLIST que se va a liberar. Este parámetro puede ser NULL.

Valor devuelto

None

Observaciones

ILFree se usa a menudo con estructuras ITEMIDLIST asignadas por una de las otras funciones il, pero se puede usar para liberar cualquier estructura de este tipo devuelta por shell, por ejemplo, la estructura ITEMIDLIST devuelta por SHBrowseForFolder o usada en una llamada a SHGetFolderLocation.

Nota Cuando use Windows 2000 o posterior, use CoTaskMemFree en lugar de ILFree. Las estructuras ITEMIDLIST siempre se asignan con el asignador de tareas Modelo de objetos componentes (COM) en esas plataformas.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también