INameSpaceTreeControl::InsertRoot method
Inserts a Shell item on a root item in a tree.
Syntax
HRESULT InsertRoot( [in] int iIndex, [in] IShellItem *psiRoot, [in] SHCONTF grfEnumFlags, [in] NSTCROOTSTYLE grfRootStyle, [in, optional] IShellItemFilter *pif );
Parameters
- iIndex [in]
-
Type: int
The index at which to insert the root.
- psiRoot [in]
-
Type: IShellItem*
A pointer to the Shell item that is being inserted.
- grfEnumFlags [in]
-
Type: SHCONTF
Enumerates the qualities of the root and all of its children. One of the values of type SHCONTF.
- grfRootStyle [in]
-
Type: NSTCROOTSTYLE
The style of the root that is being inserted. One or more of the following values (flags can be combined using a bitwise OR).
- pif [in, optional]
-
Type: IShellItemFilter*
A 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
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|