Share via

ICorProfilerInfo::SetEnterLeaveFunctionHooks Method

  • Article

Specifies profiler-implemented functions to be called on "enter", "leave", and "tailcall" hooks of managed functions.

HRESULT SetEnterLeaveFunctionHooks(
    [in] FunctionEnter    *pFuncEnter,
    [in] FunctionLeave    *pFuncLeave,
    [in] FunctionTailcall *pFuncTailcall);

Parameters

  • pFuncEnter
    [in] A pointer to the implementation to be used as the FunctionEnter callback.

  • pFuncLeave
    [in] A pointer to the implementation to be used as the FunctionLeave callback.

  • pFuncTailcall
    [in] A pointer to the implementation to be used as the FunctionTailcall callback.

Remarks

In the .NET Framework version 1.0, each function pointer can be null to disable that corresponding callback.

Only one set of callbacks can be active at a time. Thus, if a profiler calls both SetEnterLeaveFunctionHooks and ICorProfilerInfo2::SetEnterLeaveFunctionHooks2, then SetEnterLeaveFunctionHooks2 takes precedence.

The SetEnterLeaveFunctionHooks method can be called only from the profiler's ICorProfilerCallback::Initialize callback.

Requirements

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

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 1.0, 2.0

See Also

Concepts

ICorProfilerInfo Interface