ICorDebugVariableHomeEnum::Next Method

Article
09/15/2021

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

Share via