共用方式為


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)