ILFindChild 函数 (shlobj_core.h)

确定指定的 ITEMIDLIST 结构是否是另一 个 ITEMIDLIST 结构的子级。

语法

PUIDLIST_RELATIVE ILFindChild(
  [in] PIDLIST_ABSOLUTE  pidlParent,
  [in] PCIDLIST_ABSOLUTE pidlChild
);

参数

[in] pidlParent

类型： PCIDLIST_ABSOLUTE

指向父 ITEMIDLIST 结构的指针。

[in] pidlChild

类型： PCIDLIST_ABSOLUTE

指向子 ITEMIDLIST 结构的指针。

返回值

类型： PUIDLIST_RELATIVE

如果 pidlChild 是 pidlParent 的子级，则返回指向子级简单 ITEMIDLIST 结构的指针。 返回的结构由 pidlChild 减去构成 pidlParent 的 SHITEMID 结构组成。 如果 pidlChild 不是 pidlParent 的子级，则返回 NULL。

注意 返回的指针是指向现有父结构的指针。 它是 pidlChild 的别名。 不会与返回的指针关联分配任何新内存。 调用方不负责释放返回的值。

 

要求

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