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 或更高版本) |