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

Insere um item shell em um item raiz em uma árvore.

Sintaxe

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

Parâmetros

[in] iIndex

Tipo: int

O índice no qual inserir a raiz.

[in] psiRoot

Tipo: IShellItem*

Um ponteiro para o item shell que está sendo inserido.

[in] grfEnumFlags

Tipo: SHCONTF

Enumera as qualidades da raiz e de todos os seus filhos. Um dos valores do tipo SHCONTF.

[in] grfRootStyle

Tipo: NSTCROOTSTYLE

O estilo da raiz que está sendo inserida. Um ou mais dos valores a seguir (sinalizadores podem ser combinados usando um OR bit a bit).

NSTCRS_VISIBLE (0x0000)

A raiz é visível, bem como os itens. Mutuamente exclusivo com NSTCRS_HIDDEN.

NSTCRS_HIDDEN (0x0001)

A raiz fica oculta para que apenas os filhos fiquem visíveis. Mutuamente exclusivo com NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

A raiz é expandida após a inicialização.

[in, optional] pif

Tipo: IShellItemFilter*

Um ponteiro para o IShellItemFilter que permite filtrar quais itens na árvore são exibidos. Se fornecido, cada item é personalizável com um sinalizador SHCONTF . Esse valor poderá ser NULL se nenhum filtro for necessário.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)