Método INameSpaceTreeControl::AppendRoot (shobjidl_core.h)

Anexa un elemento shell a la lista de raíces de un árbol.

Sintaxis

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

Parámetros

[in] psiRoot

Tipo: IShellItem*

Puntero al elemento shell que se está anexando.

[in] grfEnumFlags

Tipo: SHCONTF

Enumera las cualidades de la raíz y de todos sus elementos secundarios. Uno o varios de los valores de tipo SHCONTF. Estas marcas se pueden combinar mediante un OR bit a bit.

[in] grfRootStyle

Tipo: NSTCROOTSTYLE

Especifica el estilo de la raíz que se está anexando. Uno o varios de los siguientes valores:

NSTCRS_VISIBLE (0x0000)

La raíz es visible, así como los elementos. Mutuamente excluyente con NSTCRS_HIDDEN.

NSTCRS_HIDDEN (0x0001)

La raíz está oculta para que los elementos secundarios solo estén visibles. Mutuamente excluyente con NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

La raíz se expande tras la inicialización.

[in] pif

Tipo: IShellItemFilter*

Puntero al IShellItemFilter que permite filtrar qué elementos del árbol se muestran. Si se proporciona, cada elemento se puede personalizar con una marca SHCONTF . Este valor puede ser NULL si no se requiere ningún filtro.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shobjidl_core.h (incluya Shobjidl.h)