IVsHierarchyItemManager.TryGetHierarchyItemIdentity Method

Gets a cached IVsHierarchyItemIdentity representing the specified hierarchy and item identifier, if one has already been created.

Namespace:  Microsoft.VisualStudio.Shell
Assembly:  Microsoft.VisualStudio.Shell.Immutable.11.0 (in Microsoft.VisualStudio.Shell.Immutable.11.0.dll)

Syntax

'Declaration
Function TryGetHierarchyItemIdentity ( _
    hierarchy As IVsHierarchy, _
    itemid As UInteger, _
    <OutAttribute> ByRef identity As IVsHierarchyItemIdentity _
) As Boolean

bool TryGetHierarchyItemIdentity(
    IVsHierarchy hierarchy,
    uint itemid,
    out IVsHierarchyItemIdentity identity
)

bool TryGetHierarchyItemIdentity(
    IVsHierarchy^ hierarchy, 
    unsigned int itemid, 
    [OutAttribute] IVsHierarchyItemIdentity^% identity
)

abstract TryGetHierarchyItemIdentity : 
        hierarchy:IVsHierarchy * 
        itemid:uint32 * 
        identity:IVsHierarchyItemIdentity byref -> bool

function TryGetHierarchyItemIdentity(
    hierarchy : IVsHierarchy, 
    itemid : uint, 
    identity : IVsHierarchyItemIdentity
) : boolean

Parameters

• hierarchy
  Type: Microsoft.VisualStudio.Shell.Interop.IVsHierarchy

  The hierarchy from which to retrieve the hierarchy item identity.

• itemid
  Type: UInt32

  The item identifier.

• identity
  Type: Microsoft.VisualStudio.Shell.IVsHierarchyItemIdentity%

  Returns the hierarchy item identity.

Return Value

Type: Boolean
true if the IVsHierarchyItemIdentity exists and was returned, otherwise false.

Remarks

The returned IVsHierarchyItemIdentity provides information about related nested hierarchies. This method only returns an identity if the corresponding identity has previously been created by GetHierarchyItem.

.NET Framework Security

• 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

IVsHierarchyItemManager Interface

Microsoft.VisualStudio.Shell Namespace