HierarchyNode.GetNestedHierarchy Method

When overridden in a derived class, gets the nested hierarchy element that is specified by the item ID.

Namespace:  Microsoft.VisualStudio.Package
Assembly:  MPF.Project.NonShipping (in MPF.Project.NonShipping.dll)

Syntax

'宣言
Public Overridable Function GetNestedHierarchy ( _
    itemId As UInteger, _
    ByRef iidHierarchyNested As Guid, _
    <OutAttribute> ByRef ppHierarchyNested As IntPtr, _
    <OutAttribute> ByRef pItemId As UInteger _
) As Integer
'使用
Dim instance As HierarchyNode
Dim itemId As UInteger
Dim iidHierarchyNested As Guid
Dim ppHierarchyNested As IntPtr
Dim pItemId As UInteger
Dim returnValue As Integer

returnValue = instance.GetNestedHierarchy(itemId, _
    iidHierarchyNested, ppHierarchyNested, _
    pItemId)

public virtual int GetNestedHierarchy(
    uint itemId,
    ref Guid iidHierarchyNested,
    out IntPtr ppHierarchyNested,
    out uint pItemId
)

public:
virtual int GetNestedHierarchy(
    unsigned int itemId, 
    Guid% iidHierarchyNested, 
    [OutAttribute] IntPtr% ppHierarchyNested, 
    [OutAttribute] unsigned int% pItemId
)

public function GetNestedHierarchy(
    itemId : uint, 
    iidHierarchyNested : Guid, 
    ppHierarchyNested : IntPtr, 
    pItemId : uint
) : int

Parameters

• itemId
  Type: System.UInt32

  Item identifier of an item in the hierarchy. Valid values are VSITEMID_NIL, VSITEMID_ROOT, and VSITEMID_SELECTION.

• iidHierarchyNested
  Type: System.Guid%

  Identifier of the interface to be returned in ppHierarchyNested.

• ppHierarchyNested
  Type: System.IntPtr%

  [out] Returns a pointer to the interface whose identifier was passed in iidHierarchyNested.

• pItemId
  Type: System.UInt32%

  [out] Returns a pointer to an item identifier of the root node of the nested hierarchy.

Return Value

Type: System.Int32

When overridden in a derived class, S_OK if the method succeeds; otherwise, an error code.

Implements

IVsUIHierarchy.GetNestedHierarchy(UInt32, Guid%, IntPtr%, UInt32%)
IVsHierarchy.GetNestedHierarchy(UInt32, Guid%, IntPtr%, UInt32%)

Remarks

Nested hierarchies are not currently used and this method returns E_FAIL. If you want this functionality, override this class in your implementation.

Permissions

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Reference

HierarchyNode Class

HierarchyNode Members

Microsoft.VisualStudio.Package Namespace

GetNestedHierarchy