Share via


IVsLibrary.GetBrowseContainersForHierarchy Method

Returns an array of Browse Containers that correspond to the given IVsHierarchy.

Namespace:  Microsoft.VisualStudio.Shell.Interop
Assembly:  Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

'Declaration
Function GetBrowseContainersForHierarchy ( _
    pHierarchy As IVsHierarchy, _
    celt As UInteger, _
    <OutAttribute> rgBrowseContainers As VSBROWSECONTAINER(), _
    <OutAttribute> pcActual As UInteger() _
) As Integer
int GetBrowseContainersForHierarchy(
    IVsHierarchy pHierarchy,
    uint celt,
    VSBROWSECONTAINER[] rgBrowseContainers,
    uint[] pcActual
)
int GetBrowseContainersForHierarchy(
    [InAttribute] IVsHierarchy^ pHierarchy, 
    [InAttribute] unsigned int celt, 
    [OutAttribute] array<VSBROWSECONTAINER>^ rgBrowseContainers, 
    [OutAttribute] array<unsigned int>^ pcActual
)
abstract GetBrowseContainersForHierarchy : 
        pHierarchy:IVsHierarchy * 
        celt:uint32 * 
        rgBrowseContainers:VSBROWSECONTAINER[] byref * 
        pcActual:uint32[] byref -> int 
function GetBrowseContainersForHierarchy(
    pHierarchy : IVsHierarchy, 
    celt : uint, 
    rgBrowseContainers : VSBROWSECONTAINER[], 
    pcActual : uint[]
) : int

Parameters

  • celt
    Type: System.UInt32
    [in] Count of elements rgBrowseContainers array.
  • pcActual
    Type: array<System.UInt32[]
    [out] Pointer to a count of containers to be returned in rgBrowseContainers.

Return Value

Type: System.Int32
If the method succeeds, it returns. S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell.idl:

HRESULT IVsLibrary::GetBrowseContainersForHierarchy(
   [in] IVsHierarchy *pHierarchy,
   [in] ULONG celt,
   [in, out, size_is(celt)] VSBROWSECONTAINER rgBrowseContainers[],
   [out, optional] ULONG *pcActual
);

The environment calls this method twice to obtain a list of browse containers corresponding to a given project hierarchy. In the first call, the environment will set celt and rgBrowseContainers to nulla null reference (Nothing in Visual Basic). Return in pcActual the number of browse containers in the hierarchy pointed to be pHierarchy. The environment then allocates the rgBrowseContainers array and calls GetBrowseContainerForHierarchy again. With this call, fill the rgBrowseContainers array with VSBROWSECONTAINER structs identifying the browse containers within your hierarchy. Return a count in celt only if your package owns the requested hierarchy. This method is meaningful only for libraries providing project browse containers.

.NET Framework Security

See Also

Reference

IVsLibrary Interface

Microsoft.VisualStudio.Shell.Interop Namespace