Export (0) Print
Expand All
Expand Minimize

ICorProfilerCallback::ExceptionCatcherEnter Method

Notifies the profiler that control is being passed to the appropriate catch block.


HRESULT ExceptionCatcherEnter(
    [in] FunctionID functionId,
    [in] ObjectID   objectId);

functionId

[in] The identifier of the function containing the catch block.

objectId

[in] The identifier of the exception being handled.

The ExceptionCatcherEnter method is called only if the catch point is in code compiled with the just-in-time (JIT) compiler. An exception that is caught in unmanaged code or in the internal code of the runtime will not call this notification. The objectId value is passed again since a garbage collection could have moved the object since the ExceptionThrown notification.

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.

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

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

Community Additions

ADD
Show:
© 2014 Microsoft