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

Acrescenta um item shell à lista de raízes em uma árvore.

Sintaxe

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

Parâmetros

[in] psiRoot

Tipo: IShellItem*

Ponteiro para o item shell que está sendo acrescentado.

[in] grfEnumFlags

Tipo: SHCONTF

Enumera as qualidades da raiz e de todos os seus filhos. Um ou mais dos valores do tipo SHCONTF. Esses sinalizadores podem ser combinados usando um OR bit a bit.

[in] grfRootStyle

Tipo: NSTCROOTSTYLE

Especifica o estilo da raiz que está sendo acrescentada. Um ou mais dos seguintes valores:

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 os filhos fiquem visíveis apenas. Mutuamente exclusivo com NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

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

[in] pif

Tipo: IShellItemFilter*

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