ILNext 函数 (shlobj_core.h)

检索 ITEMIDLIST 结构中的下一个 SHITEMID 结构。

语法

PCUIDLIST_RELATIVE ILNext(
  [in] PCUIDLIST_RELATIVE pidl
);

参数

[in] pidl

类型： PCUIDLIST_RELATIVE

要为其检索下一个 SHITEMID 结构的常量、未对齐的相对 PIDL。

返回值

类型： PCUIDLIST_RELATIVE

当此函数返回时，包含三个结果之一：如果 pidl 有效，而不是 ITEMIDLIST 中的最后一个 SHITEMID，则它包含指向下一个 ITEMIDLIST 结构的指针。 如果传递最后一个 ITEMIDLIST 结构，则它包含 NULL，表示 PIDL 结束。 对于 pidl 的其他值，返回值毫无意义。

注解

用于定义STRICT_TYPED_ITEMIDS的位置。

若要验证返回值是否为 NULL，请使用 ILIsEmpty。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
目标平台	Windows
标头	shlobj_core.h (包括 Shlobj.h)