INameSpaceTreeControl ::AppendRoot, méthode (shobjidl_core.h)

Ajoute un élément Shell à la liste des racines dans une arborescence.

Syntaxe

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

Paramètres

[in] psiRoot

Type : IShellItem*

Pointeur vers l’élément Shell en cours d’ajout.

[in] grfEnumFlags

Type : SHCONTF

Énumère les qualités de la racine et de tous ses enfants. Une ou plusieurs valeurs de type SHCONTF. Ces indicateurs peuvent être combinés à l’aide d’un or au niveau du bit.

[in] grfRootStyle

Type : NSTCROOTSTYLE

Spécifie le style de la racine qui est ajoutée. Une ou plusieurs des valeurs suivantes :

NSTCRS_VISIBLE (0x0000)

La racine est visible, ainsi que les éléments. Mutuellement exclusif avec NSTCRS_HIDDEN.

NSTCRS_HIDDEN (0x0001)

La racine est masquée afin que les enfants soient uniquement visibles. Mutuellement exclusif avec NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

La racine est développée lors de l’initialisation.

[in] pif

Type : IShellItemFilter*

Pointeur vers IShellItemFilter qui vous permet de filtrer les éléments de l’arborescence qui s’affichent. S’il est fourni, chaque élément est personnalisable avec un indicateur SHCONTF . Cette valeur peut être NULL si aucun filtre n’est requis.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)