IVsExpansionEnumeration.Next Method

Article
03/11/2013

Returns the specified number of objects from the enumeration.

Namespace: Microsoft.VisualStudio.TextManager.Interop
Assembly: Microsoft.VisualStudio.TextManager.Interop.8.0 (in Microsoft.VisualStudio.TextManager.Interop.8.0.dll)

Syntax

'Declaration
Function Next ( _
    celt As UInteger, _
    <OutAttribute> rgelt As IntPtr(), _
    <OutAttribute> ByRef pceltFetched As UInteger _
) As Integer

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

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

abstract Next : 
        celt:uint32 * 
        rgelt:IntPtr[] byref * 
        pceltFetched:uint32 byref -> int

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

Parameters

celt
Type: System.UInt32
[in] The number of VsExpansion objects to retrieve.

rgelt
Type: array<System.IntPtr[]
[out] An array that is filled in with the requested VsExpansion objects.

pceltFetched
Type: System.UInt32%
[out] The actual number of objects retrieved.

Return Value

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

Remarks

The rgelt parameter points to an array of VsExpansion objects to be filled in by this method. In managed code, memory must be allocated to hold the requested number of objects and marshaled to an IntPtr which is passed as the rgelt parameter. Upon returning, each element of the array must be marshaled back into a VsExpansion object. See the Example in the IVsExpansionEnumeration interface topic to see how this is done.

COM Signature

From textmgr2.idl:

HRESULT IVsExpansionEnumeration::Next(
   ULONG celt,
   [out, size_is(celt), length_is(*pceltFetched)] VsExpansion **rgelt,
   [out]ULONG *pceltFetched
);

.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.

Share via