IEnumHierarchies.Next Method

Article
04/22/2008

Retrieves the next group of hierarchy interfaces (IVsHierarchy).

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

Syntax

'Déclaration
Function Next ( _
    celt As UInteger, _
    <OutAttribute> rgelt As IVsHierarchy(), _
    <OutAttribute> ByRef pceltFetched As UInteger _
) As Integer
'Utilisation
Dim instance As IEnumHierarchies
Dim celt As UInteger
Dim rgelt As IVsHierarchy()
Dim pceltFetched As UInteger
Dim returnValue As Integer

returnValue = instance.Next(celt, rgelt, _
    pceltFetched)

int Next(
    uint celt,
    IVsHierarchy[] rgelt,
    out uint pceltFetched
)

int Next(
    [InAttribute] unsigned int celt, 
    [OutAttribute] array<IVsHierarchy^>^ rgelt, 
    [OutAttribute] unsigned int% pceltFetched
)

function Next(
    celt : uint, 
    rgelt : IVsHierarchy[], 
    pceltFetched : uint
) : int

Parameters

celt
Type: System.UInt32

[in] Number of hierarchies to return, or zero to indicate a request for all of the objects.

rgelt
Type: array<Microsoft.VisualStudio.Shell.Interop.IVsHierarchy[]

[out] An array of IVsHierarchy objects. Contains pceltFetched objects.

pceltFetched
Type: System.UInt32%

[out] Actual number of hierarchy interfaces retrieved.

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:

[C++]

HRESULT IEnumHierarchies::Next(
   [in] ULONG celt, 
   [out, size_is(celt), length_is(*pceltFetched)] IVsHierarchy **rgelt,    [out] ULONG *pceltFetched
);

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.

Partager via