INameSpaceTreeControl2::AppendRoot Method

Appends a Shell item to the list of roots in a tree.

Syntax

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

Parameters

  • psiRoot
    [in] Pointer to the Shell item that is being appended.
  • grfEnumFlags
    [in] Enumerates the qualities of the root and all of its children. One or more of the values of type SHCONTF. These flags can be combined using a bitwise OR.
  • grfRootStyle
    [in] Specifies the style of the root that is being appended. One or more of the following values:
    • NSTCRS_VISIBLE
      The root is visible as well as the items. Mutually exclusive with with NSTCRS_HIDDEN.
    • NSTCRS_HIDDEN
      The root is hidden so that the children only are visible. Mutually exclusive with NSTCRS_VISIBLE.
    • NSTCRS_EXPANDED
      The root is expanded upon initialization.
  • pif
    [in] Pointer to the IShellItemFilter that enables you to filter which items in the tree are displayed. If supplied, every item is customizable with a SHCONTF flag. This value can be NULL if no filter is required.

Return Value

Returns S_OK if successful, or an error value otherwise.