Metodo INameSpaceTreeControl::AppendRoot (shobjidl_core.h)

Articolo
03/05/2024

Aggiunge un elemento Shell all'elenco di radici in un albero.

Sintassi

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

Parametri

[in] psiRoot

Tipo: IShellItem*

Puntatore all'elemento Shell aggiunto.

[in] grfEnumFlags

Tipo: SHCONTF

Enumera le qualità della radice e tutti i relativi figli. Uno o più valori di tipo SHCONTF. Questi flag possono essere combinati usando un OR bit per bit.

[in] grfRootStyle

Tipo: NSTCROOTSTYLE

Specifica lo stile della radice aggiunta. Uno o più dei valori seguenti:

NSTCRS_VISIBLE (0x0000)

La radice è visibile e gli elementi. Si escludono a vicenda con NSTCRS_HIDDEN.

NSTCRS_HIDDEN (0x0001)

La radice è nascosta in modo che gli elementi figlio siano visibili solo. Si escludono a vicenda con NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

La radice viene espansa all'inizializzazione.

[in] pif

Tipo: IShellItemFilter*

Puntatore a IShellItemFilter che consente di filtrare gli elementi nell'albero. Se specificato, ogni elemento è personalizzabile con un flag SHCONTF . Questo valore può essere NULL se non è necessario alcun filtro.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Share via