ICorProfilerCallback::ExceptionThrown Method

  • Article

Notifies the profiler that an exception has been thrown.

NoteNote:

This function is called only if the exception reaches managed code.

 
HRESULT ExceptionThrown(
    [in] ObjectID thrownObjectId);

Parameters

  • thrownObjectId
    [in] The ID of the object that caused the exception to be thrown.

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: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorProf.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Concepts

ICorProfilerCallback Interface