ILFree 函数 (shlobj_core.h)

释放 Shell 分配的 ITEMIDLIST 结构。

语法

void ILFree(
  [in] PIDLIST_RELATIVE pidl
);

参数

[in] pidl

类型: PIDLIST_RELATIVE

指向要释放的 ITEMIDLIST 结构的指针。 此参数可以为 NULL。

返回值

备注

ILFree 通常用于由其他 IL 函数之一分配的 ITEMIDLIST 结构,但它可用于释放 Shell 返回的任何此类结构,例如,SHBrowseForFolder 返回的 ITEMIDLIST 结构,或在调用 SHGetFolderLocation 中使用的 ITEMIDLIST 结构。

注意 使用 Windows 2000 或更高版本时,请使用 CoTaskMemFree 而不是 ILFreeITEMIDLIST 结构始终在这些平台上使用组件对象模型 (COM) 任务分配器进行分配。
 

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shlobj_core.h (包括 Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (5.0 或更高版本)

另请参阅

ILAppendID

ILClone

ILCloneFirst

ILCombine