ICorProfilerCallback::ExceptionUnwindFinallyEnter Method

Notifies the profiler that the unwind phase of exception handling is entering a finally clause contained in the specified function.

HRESULT ExceptionUnwindFinallyEnter(
    [in] FunctionID functionId);

Parameters

  • functionId
    [in] The ID of the function that contains the finally clause.

Remarks

The profiler should not block in its implementation of this method because the stack may not be in a state that allows garbage collection, and therefore preemptive garbage collection cannot be enabled. If the profiler blocks here and garbage collection is attempted, the runtime will block until this callback returns.

The profiler's implementation of this method should not call into managed code or in any way cause a managed-memory allocation.

Requirements

Platforms: See .NET Framework System Requirements.

Header: CorProf.idl, CorProf.h

Library: CorGuids.lib

.NET Framework Versions: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

See Also

Reference

ICorProfilerCallback Interface

ICorProfilerInfo2::GetNotifiedExceptionClauseInfo Method

ICorProfilerCallback::ExceptionUnwindFinallyLeave Method