IVsEnumTaskItems.Next Method

Article
02/04/2013

Retrieves a specified number of task items in the enumeration sequence.

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

Syntax

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

int Next(
    uint celt,
    IVsTaskItem[] rgelt,
    uint[] pceltFetched
)

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

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

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

Parameters

celt
Type: System.UInt32
[in] The requested number of task items to retrieve.

rgelt
Type: array<Microsoft.VisualStudio.Shell.Interop.IVsTaskItem[]
[out, size_is(celt), length_is(*pceltFetched)] The list of IVsTaskItem2 interfaces of the task items that have been retrieved.

pceltFetched
Type: array<System.UInt32[]
[out] Pointer to the actual number of tasks supplied in rgelt. The caller of this method can set this to nulla null reference (Nothing in Visual Basic) if celt is one.

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 IVsEnumTaskItems::Next(
   [in] ULONG celt,
   [out, size_is(celt), length_is(*pceltFetched)] IVsTaskItem **rgelt,
   [out, optional] ULONG *pceltFetched
);

The tasks are retrieved from the current position of the enumeration. The Reset and Skip methods of this interface can be used to get to a particular position of the enumeration before using IVsEnumTaskItems.Next to retrieve task items from the enumeration.

Refer to the Remarks under the Reset method.

.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