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 而不是 ILFree。 ITEMIDLIST 结构始终在这些平台上使用组件对象模型 (COM) 任务分配器进行分配。
 

要求

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

另请参阅

ILAppendID

ILClone

ILCloneFirst

ILCombine