INameSpaceTreeControl：：AppendRoot 方法 (shobjidl_core.h)

将 Shell 项追加到树中的根列表。

语法

HRESULT AppendRoot(
  [in] IShellItem       *psiRoot,
  [in] SHCONTF          grfEnumFlags,
  [in] NSTCROOTSTYLE    grfRootStyle,
  [in] IShellItemFilter *pif
);

参数

[in] psiRoot

类型： IShellItem*

指向要追加的 Shell 项的指针。

[in] grfEnumFlags

类型： SHCONTF

枚举根及其所有子级的质量。 SHCONTF 类型的一个或多个值。 可以使用按位 OR 组合这些标志。

[in] grfRootStyle

类型： NSTCROOTSTYLE

指定要追加的根的样式。 以下一个或多个值：

NSTCRS_VISIBLE (0x0000)

根和项都可见。 与NSTCRS_HIDDEN互斥。

NSTCRS_HIDDEN (0x0001)

根是隐藏的，以便子级仅可见。 与NSTCRS_VISIBLE互斥。

NSTCRS_EXPANDED (0x0002)

根在初始化时扩展。

[in] pif

类型： IShellItemFilter*

指向 IShellItemFilter 的 指针，可用于筛选树中显示的项。 如果提供，则每个项都可以使用 SHCONTF 标志进行自定义。 如果不需要任何筛选器，此值可以为 NULL 。

返回值

类型： HRESULT

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

要求

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