Edit

ICorDebugManagedCallback::DebuggerError Method

  • Article

Notifies the debugger that an error has occurred while attempting to handle an event from the common language runtime (CLR).

Syntax

HRESULT DebuggerError (  
    [in] ICorDebugProcess *pProcess,  
    [in] HRESULT           errorHR,  
    [in] DWORD             errorCode  
);

Parameters

pProcess
[in] A pointer to an "ICorDebugProcess" object that represents the process in which the event occurred.

errorHR
[in] The HRESULT value that was returned from the event handler.

errorCode
[in] An integer that specifies the CLR error.

Remarks

The process may be placed into pass-through mode, depending on the nature of the error.

The DebugError callback indicates that debugging services have been disabled due to an error, so debuggers should make the error message available to the user. ICorDebugProcess::GetID will be safe to call, but all other methods, including ICorDebug::Terminate, should not be called. The debugger should use operating-system facilities for terminating processes.

Requirements

Platforms: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 1.0

See also