INameSpaceTreeControl::GetNextItem method
Retrieves the next item in the tree according to which method is requested.
Syntax
HRESULT GetNextItem( [in, optional] IShellItem *psi, [in] NSTCGNI nstcgi, [out] IShellItem **ppsiNext );
Parameters
- psi [in, optional]
-
Type: IShellItem*
The Shell item for which the next item is being retrieved. This value can be NULL.
- nstcgi [in]
-
Type: NSTCGNI
The type of the next item. This value can be one of the following flags:
-
The next sibling of the given item.
-
The next visible item in the tree that has any relationship to the given item. This includes a child (if there is one), the next sibling, or even one of the ancestor's siblings.
-
The previous sibling item of the given item.
-
The previous visible item that is a sibling item, sibling descendent item or a parent item.
-
The parent item of the given item.
-
The first child item of the given item.
-
The absolute first visible item in the tree (not relative to the given item).
-
The absolute last visible item in the tree (not relative to the given item).
- ppsiNext [out]
-
Type: IShellItem**
The address of a pointer to the IShellItem that fits the criteria for the next item that was requested.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
If there is no next item for the type selected, this function returns E_FAIL with NULL for the returned item, ppsiNext.
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
IDL |
|