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 錯誤碼。

規格需求