PyIRemoteDebugApplication.md

PyIRemoteDebugApplication

PyIRemoteDebugApplication Object

Description of the interface

Methods

• ResumeFromBreakPoint

  Continue an application which is currently in a breakpoint. 

• CauseBreak

  Causes the application to break into the debugger at the earliest opportunity. 

• ConnectDebugger

  Connects a debugger to the application. 

• DisconnectDebugger

  Disconnects the current debugger from the application. 

• GetDebugger

  Returns the current debugger connected to the application. 

• CreateInstanceAtApplication

  Create objects in the application process address space. 

• QueryAlive

  Indicates if the application is alive. 

• EnumThreads

  Enumerates all threads known to be associated with the application. 

• GetName

  Description of GetName 

• GetRootNode

  Returns the application node under which all nodes associated with the application are added. 

• EnumGlobalExpressionContexts

  Enumerates all global expression contexts. 

PyIRemoteDebugApplication.CauseBreak

CauseBreak() Causes the application to break into the debugger at the earliest opportunity.

Comments

Note that a long time may elapse before the application actually breaks, particularly if

the application is not currently executing script code.

PyIRemoteDebugApplication.ConnectDebugger

ConnectDebugger(pad) Connects a debugger to the application.

Parameters

• pad : PyIApplicationDebugger

  Description for pad

Comments

Only one debugger may be connected at a

time; this method fails if there is already a debugger connected.

PyIRemoteDebugApplication.CreateInstanceAtApplication

PyIUnknown = CreateInstanceAtApplication(rclsid, pUnkOuter

, dwClsContext

, riid

) Create objects in the application process address space.

Parameters

• rclsid : PyIID

  Description for rclsid

• pUnkOuter : PyIUnknown

  Description for pUnkOuter

• dwClsContext : int

  Description for dwClsContext

• riid : PyIID

  Description for riid

Comments

Provides a mechanism for the debugger IDE, running out-of-process to the

application, to create objects in the application process.

This method simply delegates to CoCreateInstance.

PyIRemoteDebugApplication.DisconnectDebugger

DisconnectDebugger() Disconnects the current debugger from the application.

PyIRemoteDebugApplication.EnumGlobalExpressionContexts

IEnumDebugExpressionContexts

= EnumGlobalExpressionContexts() Enumerates all global expression contexts

PyIRemoteDebugApplication.EnumThreads

PyIEnumRemoteDebugApplicationThreads = EnumThreads() Enumerates all threads known to be associated with the application.

Comments

New threads may be added at any time.

PyIRemoteDebugApplication.GetDebugger

PyIApplicationDebugger = GetDebugger() Returns the current debugger connected to the application.

PyIRemoteDebugApplication.GetName

GetName() Description of GetName.

PyIRemoteDebugApplication.GetRootNode

PyIDebugApplicationNode = GetRootNode() Returns the application node under which all nodes associated with the application are added.

PyIRemoteDebugApplication.QueryAlive

QueryAlive() Returns True if alive, else False.

PyIRemoteDebugApplication.ResumeFromBreakPoint

ResumeFromBreakPoint(prptFocus, bra, era) Continue an application which is currently in a breakpoint.

Parameters

• prptFocus : PyIRemoteDebugApplicationThread

  Description for prptFocus

• bra : int

  Break resume action

• era : int

  Error resume action