INameSpaceTreeControl：：GetNextItem 方法 (shobjidl_core.h)

根据请求的方法检索树中的下一项。

语法

HRESULT GetNextItem(
  [in, optional] IShellItem *psi,
  [in]           NSTCGNI    nstcgi,
  [out]          IShellItem **ppsiNext
);

参数

[in, optional] psi

类型： IShellItem*

要为其检索下一项的 Shell 项。 此值可以为 NULL。

[in] nstcgi

类型： NSTCGNI

下一项的类型。 此值可以是以下标志之一：

NSTCGNI_NEXT (0)

给定项的下一个同级。

NSTCGNI_NEXTVISIBLE (1)

树中与给定项具有任何关系的下一个可见项。 这包括子 (，如果有一个) ，下一个兄弟姐妹，甚至祖先的兄弟姐妹之一。

NSTCGNI_PREV (2)

给定项的上一个同级项。

NSTCGNI_PREVVISIBLE (3)

作为同级项、同级子代项或父项的上一个可见项。

NSTCGNI_PARENT (4)

给定项的父项。

NSTCGNI_CHILD (5)

给定项的第一个子项。

NSTCGNI_FIRSTVISIBLE (6)

树中的第一个绝对可见项 (与给定项) 不相关。

NSTCGNI_LASTVISIBLE (7)

树中最后一个可见的绝对项 (与给定项) 不相关。

[out] ppsiNext

类型： IShellItem**

指向 IShellItem 的指针的地址，该指针符合所请求的下一项的条件。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

如果所选类型没有下一项，此函数将返回E_FAIL，返回的项 ppsiNext 为 NULL。

要求

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