Share via


ICorDebugThread2::GetActiveFunctions Method

Gets information about the active function in each of this thread's frames.

HRESULT GetActiveFunctions (
    [in]   ULONG32             cFunctions,
    [out]  ULONG32             *pcFunctions,
    [in, out, size_is(cFunctions), length_is(*pcFunctions)]
        COR_ACTIVE_FUNCTION    pFunctions[]
);

Parameters

  • cFunctions
    [in] The size of the pFunctions array.

  • pcFunctions
    [out] A pointer to the number of objects returned in the pFunctions array. The number of objects returned will be equal to the number of managed frames on the stack.

  • pFunctions
    [in, out] An array of COR_ACTIVE_FUNCTION objects, each of which contains information about the active functions in this thread's frames.

    The first element will be used for the leaf frame, and so on back to the root of the stack.

Remarks

If pFunctions is null on input, GetActiveFunctions returns only the number of functions that are on the stack. That is, If pFunctions is null on input, GetActiveFunctions returns a value only in pcFunctions.

The GetActiveFunctions method is intended as an optimization over getting the same information from frames in a stack trace, and includes only frames that would have had an ICorDebugILFrame object for them in the full stack trace.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Concepts

ICorDebugThread2 Interface

ICorDebugThread Interface