IDebugProgramNode2

  • Article

This interface represents a program that can be debugged.

IDebugProgramNode2 : IUnknown

Notes for Implementers

A debug engine (DE) or a custom port supplier implements this interface to represent a program that can be debugged. This interface is typically implemented on the same object that implements the IDebugProgram2 interface. This interface is registered with Visual Studio by calling IDebugProgramPublisher2::PublishProgramNode.

Notes for Callers

Call IDebugProgramProvider2::GetProviderProgramNode to return this interface. A custom port supplier receives this interface through a call to IDebugPortNotify2::AddProgramNode. A DE receives this interface through a call to IDebugEngine2::Attach.

Methods in Vtable Order

The following table shows the methods of IDebugProgramNode2.

Method

Description

IDebugProgramNode2::GetProgramName

Gets the name of a program.

IDebugProgramNode2::GetHostName

Gets the name of the process hosting a program.

IDebugProgramNode2::GetHostPid

Gets the system process identifier for the process hosting a program.

IDebugProgramNode2::GetHostMachineName_V7

DEPRECATED. DO NOT USE.

IDebugProgramNode2::Attach_V7

DEPRECATED. DO NOT USE. See the IDebugProgramNodeAttach2 interface for an alternative approach.

IDebugProgramNode2::GetEngineInfo

Gets the name and identifier of the DE running this program.

IDebugProgramNode2::DetachDebugger_V7

DEPRECATED. DO NOT USE.

Remarks

The session debug manager (SDM) typically calls IDebugProgramProvider2::GetProviderProgramNode to obtain this interface.

Requirements

Header: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

See Also

Reference

IDebugProgramNodeAttach2

IDebugPortNotify2::AddProgramNode

IDebugPortNotify2::RemoveProgramNode

IDebugEngine2::Attach

IDebugProgramProvider2::GetProviderProgramNode

IDebugProgramPublisher2::PublishProgramNode

Concepts

Core Interfaces