Export (0) Print
Expand All
Expand Minimize

ILFree function

Frees an ITEMIDLIST structure allocated by the Shell.

Syntax


void ILFree(
  _In_  PIDLIST_RELATIVE pidl
);

Parameters

pidl [in]

Type: PIDLIST_RELATIVE

A pointer to the ITEMIDLIST structure to be freed. This parameter can be NULL.

Return value

This function does not return a value.

Remarks

ILFree is often used with ITEMIDLIST structures allocated by one of the other IL functions, but it can be used to free any such structure returned by the Shell—for example, the ITEMIDLIST structure returned by SHBrowseForFolder or used in a call to SHGetFolderLocation.

Note  When using Windows 2000 or later, use CoTaskMemFree rather than ILFree. ITEMIDLIST structures are always allocated with the Component Object Model (COM) task allocator on those platforms.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll (version 5.0 or later)

See also

ILAppendID
ILClone
ILCloneFirst
ILCombine

 

 

Community Additions

ADD
Show:
© 2014 Microsoft