IVsLibrary2.GetBrowseContainersForHierarchy Method

Article
04/29/2015

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

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.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

pHierarchy
Type: Microsoft.VisualStudio.Shell.Interop.IVsHierarchy

[in] Pointer to an IVsHierarchy interface.

celt
Type: UInt32

[in] The number of elements in the rgBrowseContainers array.

rgBrowseContainers
Type: array<Microsoft.VisualStudio.Shell.Interop.VSBROWSECONTAINER[]

[in, out] On input, nulla null reference (Nothing in Visual Basic). On output, an array of VSBROWSECONTAINER structures.

pcActual
Type: array<UInt32[]

[out] The actual number of containers returned in rgBrowseContainers.

Return Value

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

Remarks

COM Signature

From vsshell80.idl:

HRESULT IVsLibrary2::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 sets celt and rgBrowseContainers to nulla null reference (Nothing in Visual Basic). This method returns in the pcActual parameter the number of browse containers in the hierarchy pointed to be pHierarchy. The environment then allocates the rgBrowseContainers array and calls GetBrowseContainersForHierarchy again. With this call, the method fills the rgBrowseContainers array with VSBROWSECONTAINER structures 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

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.

Partager via