IDebugApplication::HandleRuntimeError

  • Article

Causes the current thread to block and sends a notification of the error to the debugger IDE.

Syntax

HRESULT HandleRuntimeError(  
   IActiveScriptErrorDebug*  pErrorDebug,  
   IActiveScriptSite*        pScriptSite,  
   BREAKRESUMEACTION*        pbra,  
   ERRORRESUMEACTION*        perra,  
   BOOL*                     pfCallOnScriptError  
);

Parameters

pErrorDebug
[in] The error that occurred.

pScriptSite
[in] The script site of the thread.

pbra
[out] Action to take when the debugger resumes the application.

perra
[out] Action to take when the debugger resumes the application if there is an error.

pfCallOnScriptError
[out] Flag which is TRUE if the engine should call the IActiveScriptSite::OnScriptError method.

Return Value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Value Description
S_OK The method succeeded.

Remarks

A language engine calls this method in the context of a thread that causes a run-time error. This method causes the current thread to block and sends an error notification to be sent to the debugger IDE. When the debugger IDE resumes the application, this method returns with the action to be taken.

Note

While in the run-time fault, the language engine may be called by the thread to do such tasks as enumerate stack frames or evaluate expressions.

See also

IDebugApplication Interface
IActiveScriptErrorDebug Interface
IActiveScriptSite
BREAKRESUMEACTION Enumeration
ERRORRESUMEACTION Enumeration