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.