C# Класс VSNDK.DebugEngine.AD7Process

Наследование: IDebugProcess2

Показать файл Открыть проект Примеры использования класса

Открытые свойства

Свойство	Тип	Описание
_name	string
_portAttach	AD7Port
_processGUID	System.Guid
_processID	string
m_program	IDebugProgram2

Защищенные свойства (Protected)

Свойство	Тип	Описание
_engine	AD7Engine

Открытые методы

Метод	Описание
AD7Process ( AD7Engine aEngine, IDebugPort2 aPort ) : System	Constructor.
AD7Process ( AD7Port aPort, string ID, string name ) : System	Constructor.
AddImplicitProgramNodes ( System.Guid &guidLaunchingEngine, System.Guid rgguidSpecificEngines, uint celtSpecificEngines ) : int	Adds program nodes for a list of debug engines. (http://msdn.microsoft.com/en-us/library/bb146990.aspx) In this project, it is used only one debug engine, that's why its GUID is assigned to the guidLaunchingEngine explicitly.
Attach ( IDebugEventCallback2 pCallback, System.Guid rgguidSpecificEngines, uint celtSpecificEngines, int rghrEngineAttach ) : int	Attaches the session debug manager (SDM) to the process. Not implemented. Currently using IDebugEngine2.Attach. (http://msdn.microsoft.com/en-ca/library/bb145875.aspx)
Attach ( IDebugSession2 pSession ) : int	Informs the process that a session is now debugging the process. (http://msdn.microsoft.com/en-us/library/bb162300.aspx)
CanDetach ( ) : int	Determines if the session debug manager (SDM) can detach the process. Not implemented. (http://msdn.microsoft.com/en-us/library/bb145567.aspx)
CauseBreak ( ) : int	Requests that the next program that is running code in this process halt and send an IDebugBreakEvent2 event object. Not implemented. (http://msdn.microsoft.com/en-us/library/bb162292.aspx)
Detach ( ) : int	Detaches the debugger from this process by detaching all of the programs in the process. (http://msdn.microsoft.com/en-us/library/bb162197.aspx)
Detach ( IDebugSession2 pSession ) : int	Informs the process that a session is no longer debugging the process. (http://msdn.microsoft.com/en-us/library/bb146313.aspx)
EnumPrograms ( IEnumDebugPrograms2 &ppEnum ) : int	Retrieves a list of all the programs contained by this process. (http://msdn.microsoft.com/en-us/library/bb162305.aspx)
EnumThreads ( IEnumDebugThreads2 &ppEnum ) : int	Retrieves a list of all the threads running in all programs in the process. Not implemented. (http://msdn.microsoft.com/en-us/library/bb144981.aspx)
GetAttachedSessionName ( string &pbstrSessionName ) : int	Gets the name of the session that is debugging the process. [DEPRECATED. SHOULD ALWAYS RETURN E_NOTIMPL.] (http://msdn.microsoft.com/en-us/library/bb146718.aspx)
GetInfo ( enum_PROCESS_INFO_FIELDS Fields, PROCESS_INFO pProcessInfo ) : int	Gets a description of the process. (http://msdn.microsoft.com/en-us/library/bb145895.aspx)
GetName ( enum_GETNAME_TYPE gnType, string &pbstrName ) : int	Gets the name of the process. (http://msdn.microsoft.com/en-us/library/bb161270.aspx)
GetPhysicalProcessId ( AD_PROCESS_ID pProcessId ) : int	Gets the system process identifier. (http://msdn.microsoft.com/en-us/library/bb146648.aspx)
GetPort ( IDebugPort2 &ppPort ) : int	Gets the port that the process is running on. (http://msdn.microsoft.com/en-us/library/bb162121.aspx)
GetProcessId ( System.Guid &pguidProcessId ) : int	Gets the GUID for this process. (http://msdn.microsoft.com/en-us/library/bb161938.aspx)
GetServer ( IDebugCoreServer2 &ppServer ) : int	Gets the server that this process is running on. Not implemented completely because _server has no value assigned to it. (http://msdn.microsoft.com/en-us/library/bb147017.aspx)
Terminate ( ) : int	Terminates the process. Not implemented. (http://msdn.microsoft.com/en-us/library/bb146226.aspx)

Описание методов

AD7Process() публичный Метод

Constructor.

public AD7Process ( AD7Engine aEngine, IDebugPort2 aPort ) : System
aEngine	AD7Engine	The AD7Engine object that represents the DE.
aPort	IDebugPort2	The IDebugPort2 object that represents the port on which the process was launched.
Результат	System

AD7Process() публичный Метод

Constructor.

public AD7Process ( AD7Port aPort, string ID, string name ) : System
aPort	AD7Port	The AD7Port object that represents the port used in Attach to Process UI.
ID	string	The process ID.
name	string	The process name.
Результат	System

AddImplicitProgramNodes() публичный Метод

Adds program nodes for a list of debug engines. (http://msdn.microsoft.com/en-us/library/bb146990.aspx) In this project, it is used only one debug engine, that's why its GUID is assigned to the guidLaunchingEngine explicitly.

public AddImplicitProgramNodes ( System.Guid &guidLaunchingEngine, System.Guid rgguidSpecificEngines, uint celtSpecificEngines ) : int
guidLaunchingEngine	System.Guid	The GUID of a DE that is to be used to launch programs (and is assumed to add its own /// program nodes).
rgguidSpecificEngines	System.Guid	Array of GUIDs of DEs for which program nodes will be added.
celtSpecificEngines	uint	The number of GUIDs in the rgguidSpecificEngines array.
Результат	int

Attach() публичный Метод

Attaches the session debug manager (SDM) to the process. Not implemented. Currently using IDebugEngine2.Attach. (http://msdn.microsoft.com/en-ca/library/bb145875.aspx)

public Attach ( IDebugEventCallback2 pCallback, System.Guid rgguidSpecificEngines, uint celtSpecificEngines, int rghrEngineAttach ) : int
pCallback	IDebugEventCallback2	An IDebugEventCallback2 object that is used for debug event notification.
rgguidSpecificEngines	System.Guid	An array of GUIDs of debug engines to be used to debug programs running in the process. /// This parameter can be a null value.
celtSpecificEngines	uint	The number of debug engines in the rgguidSpecificEngines array and the size of the /// rghrEngineAttach array.
rghrEngineAttach	int	An array of HRESULT codes returned by the debug engines.
Результат	int

Attach() публичный Метод

Informs the process that a session is now debugging the process. (http://msdn.microsoft.com/en-us/library/bb162300.aspx)

public Attach ( IDebugSession2 pSession ) : int
pSession	IDebugSession2	A value that uniquely identifies the session attaching to this process.
Результат	int

CanDetach() публичный Метод

Determines if the session debug manager (SDM) can detach the process. Not implemented. (http://msdn.microsoft.com/en-us/library/bb145567.aspx)

public CanDetach ( ) : int
Результат	int

CauseBreak() публичный Метод

Requests that the next program that is running code in this process halt and send an IDebugBreakEvent2 event object. Not implemented. (http://msdn.microsoft.com/en-us/library/bb162292.aspx)

public CauseBreak ( ) : int
Результат	int

Detach() публичный Метод

Detaches the debugger from this process by detaching all of the programs in the process. (http://msdn.microsoft.com/en-us/library/bb162197.aspx)

public Detach ( ) : int
Результат	int

Detach() публичный Метод

Informs the process that a session is no longer debugging the process. (http://msdn.microsoft.com/en-us/library/bb146313.aspx)

public Detach ( IDebugSession2 pSession ) : int
pSession	IDebugSession2	A value that uniquely identifies the session to detach this process from.
Результат	int

EnumPrograms() публичный Метод

Retrieves a list of all the programs contained by this process. (http://msdn.microsoft.com/en-us/library/bb162305.aspx)

public EnumPrograms ( IEnumDebugPrograms2 &ppEnum ) : int
ppEnum	IEnumDebugPrograms2	Returns an IEnumDebugPrograms2 object that contains a list of all the programs in the process.
Результат	int

EnumThreads() публичный Метод

Retrieves a list of all the threads running in all programs in the process. Not implemented. (http://msdn.microsoft.com/en-us/library/bb144981.aspx)

public EnumThreads ( IEnumDebugThreads2 &ppEnum ) : int
ppEnum	IEnumDebugThreads2	Returns an IEnumDebugThreads2 object that contains a list of all threads in all programs in the /// process.
Результат	int

GetAttachedSessionName() публичный Метод

Gets the name of the session that is debugging the process. [DEPRECATED. SHOULD ALWAYS RETURN E_NOTIMPL.] (http://msdn.microsoft.com/en-us/library/bb146718.aspx)

public GetAttachedSessionName ( string &pbstrSessionName ) : int
pbstrSessionName	string	DEPRECATED. Return null.
Результат	int

GetInfo() публичный Метод

Gets a description of the process. (http://msdn.microsoft.com/en-us/library/bb145895.aspx)

public GetInfo ( enum_PROCESS_INFO_FIELDS Fields, PROCESS_INFO pProcessInfo ) : int
Fields	enum_PROCESS_INFO_FIELDS	A combination of values from the PROCESS_INFO_FIELDS enumeration that specifies which fields of /// the pProcessInfo parameter are to be filled in.
pProcessInfo	PROCESS_INFO	A PROCESS_INFO structure that is filled in with a description of the process.
Результат	int

GetName() публичный Метод

Gets the name of the process. (http://msdn.microsoft.com/en-us/library/bb161270.aspx)

public GetName ( enum_GETNAME_TYPE gnType, string &pbstrName ) : int
gnType	enum_GETNAME_TYPE	A value from the GETNAME_TYPE enumeration that specifies what type of name to return.
pbstrName	string	Returns the name of the process.
Результат	int

GetPhysicalProcessId() публичный Метод

Gets the system process identifier. (http://msdn.microsoft.com/en-us/library/bb146648.aspx)

public GetPhysicalProcessId ( AD_PROCESS_ID pProcessId ) : int
pProcessId	AD_PROCESS_ID	An AD_PROCESS_ID structure that is filled in with the system process identifier information.
Результат	int

GetPort() публичный Метод

Gets the port that the process is running on. (http://msdn.microsoft.com/en-us/library/bb162121.aspx)

public GetPort ( IDebugPort2 &ppPort ) : int
ppPort	IDebugPort2	Returns an IDebugPort2 object that represents the port on which the process was launched.
Результат	int

GetProcessId() публичный Метод

Gets the GUID for this process. (http://msdn.microsoft.com/en-us/library/bb161938.aspx)

public GetProcessId ( System.Guid &pguidProcessId ) : int
pguidProcessId	System.Guid	Returns the GUID for this process.
Результат	int

GetServer() публичный Метод

Gets the server that this process is running on. Not implemented completely because _server has no value assigned to it. (http://msdn.microsoft.com/en-us/library/bb147017.aspx)

public GetServer ( IDebugCoreServer2 &ppServer ) : int
ppServer	IDebugCoreServer2	Returns an IDebugCoreServer2 object that represents the server on which this process is running.
Результат	int

Terminate() публичный Метод

Terminates the process. Not implemented. (http://msdn.microsoft.com/en-us/library/bb146226.aspx)

public Terminate ( ) : int
Результат	int

Описание свойств

_engine защищенное свойство

The AD7Engine object that represents the DE.

protected AD7Engine,VSNDK.DebugEngine _engine
Результат	AD7Engine

_name публичное свойство

The name of the process. Not used till now. Has no value assigned to it.

public string _name
Результат	string

_portAttach публичное свойство

The AD7Port object that represents the port used in Attach to Process UI.

public AD7Port,VSNDK.DebugEngine _portAttach
Результат	AD7Port

_processGUID публичное свойство

Process GUID.

public Guid,System _processGUID
Результат	System.Guid

_processID публичное свойство

Process ID.

public string _processID
Результат	string

m_program публичное свойство

A program that is running in this process. It should be an array of programs, as a process "is a container for a set of programs" but, at this moment, the VSNDK supports only one program at a time.

public IDebugProgram2 m_program
Результат	IDebugProgram2