INameSpaceTreeControl：：InsertRoot 方法 (shobjidl_core.h)

在树中的根项上插入 Shell 项。

语法

HRESULT InsertRoot(
  [in]           int              iIndex,
  [in]           IShellItem       *psiRoot,
  [in]           SHCONTF          grfEnumFlags,
  [in]           NSTCROOTSTYLE    grfRootStyle,
  [in, optional] IShellItemFilter *pif
);

参数

[in] iIndex

类型： int

要插入根的索引。

[in] psiRoot

类型： IShellItem*

指向要插入的 Shell 项的指针。

[in] grfEnumFlags

类型： SHCONTF

枚举根及其所有子级的质量。 SHCONTF 类型的值之一。

[in] grfRootStyle

类型： NSTCROOTSTYLE

要插入的根的样式。 可以使用按位 OR) 组合以下一个或多个值 (标志。

NSTCRS_VISIBLE (0x0000)

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

NSTCRS_HIDDEN (0x0001)

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

NSTCRS_EXPANDED (0x0002)

根在初始化时扩展。

[in, optional] pif

类型： IShellItemFilter*

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

返回值

类型： HRESULT

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

要求

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