Edit

ICorDebugVariableHomeEnum::Next Method

  • Article

Gets the specified number of ICorDebugVariableHome instances that contain information about the local variables and arguments in a function.

Syntax

HRESULT Next(  
    [in] ULONG celt,  
    [out, size_is(celt), length_is(*pceltFetched)] ICorDebugVariableHome *homes[],  
    [out] ULONG *pceltFetched  
);

Parameters

celt
[in] The number of objects to be retrieved.

homes
An array of pointers, each of which points to a ICorDebugVariableHome object that provides information about a local variable or argument of a function.

pceltFetched
[out] The number of instances actually returned in objects.

Return Value

The method returns the following values.

HRESULT Description
S_OK The method completed successfully.
S_FALSE The actual number of instances retrieved, as reflected in pceltFetched, is less than the number of instances requested.

Remarks

The ICorDebugVariableHomeEnum::Next method retrieves a maximum of celt objects starting at the current position of the enumerator. When the method returns, pceltFetched contains the actual number of objects retrieved.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4.6.2

See also