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

Inserta un elemento de Shell en un elemento raíz de un árbol.

Sintaxis

HRESULT InsertRoot(
  [in]           int              iIndex,
  [in]           IShellItem       *psiRoot,
  [in]           SHCONTF          grfEnumFlags,
  [in]           NSTCROOTSTYLE    grfRootStyle,
  [in, optional] IShellItemFilter *pif
);

Parámetros

[in] iIndex

Tipo: int

Índice en el que se va a insertar la raíz.

[in] psiRoot

Tipo: IShellItem*

Puntero al elemento shell que se va a insertar.

[in] grfEnumFlags

Tipo: SHCONTF

Enumera las cualidades de la raíz y de todos sus elementos secundarios. Uno de los valores de tipo SHCONTF.

[in] grfRootStyle

Tipo: NSTCROOTSTYLE

Estilo de la raíz que se va a insertar. Uno o varios de los siguientes valores (las marcas se pueden combinar mediante un OR bit a bit).

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 solo los elementos secundarios estén visibles. Mutuamente excluyente con NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

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

[in, optional] 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)