IVsEnumTaskItems::Next Method (UInt32, array<IVsTaskItem^>^, array<UInt32>^)

Visual Studio 2015

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

C++

int Next(
	unsigned int celt,
	array<IVsTaskItem^>^ rgelt,
	array<unsigned int>^ pceltFetched
)

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 null 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:

C++

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.