DkmProcess.Create Methode

Referenz

Definition

Namespace:: Microsoft.VisualStudio.Debugger

Assembly:: Microsoft.VisualStudio.Debugger.Engine.dll

Paket:: Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Überlädt

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Erstellt ein neues Prozessobjekt. Diese Methode wird vom Basisdebugmonitor für den Ereignisthread als Teil der Verarbeitung von IDkmStartDebuggingOperations.AttachToProcess oder IDkmStartDebuggingOperations.ResumeDebuggedProcess aufgerufen.

Diese Methode sendet ein ProcessCreate-Ereignis.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) eingeführt.

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Diese Methode sendet ein ProcessCreate-Ereignis.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)

Diese Methode sendet ein ProcessCreate-Ereignis.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Diese Methode sendet ein ProcessCreate-Ereignis.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) eingeführt.

public static Microsoft.VisualStudio.Debugger.DkmProcess Create(Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsMultiArch, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * bool * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess

Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsAppPackage As Boolean, IsMultiArch As Boolean, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess

Parameter

Connection: DkmTransportConnection

[In] Dies stellt eine Verbindung zwischen dem Monitor und der IDE dar. Es kann sich entweder um eine lokale Verbindung handelt, wenn der Monitor im selben Prozess wie die IDE ausgeführt wird, oder es kann sich um eine Remoteverbindung handelt. Im Überwachungsprozess gibt es nur eine Verbindung.

Path: String

[In] Vollständiger Pfad zur ausführbaren Startdatei des Prozesses.

UniqueId: Guid

[In] Guid, die dieses Prozessobjekt eindeutig identifiziert. Dieser Guid-Wert ist mit dem GUID identisch, der auf der SDM-Ebene (IDebugProcess2::GetProcessId) und auf der Automatisierungsebene verfügbar gemacht wird.

StartMethod: DkmStartMethod

[In] StartMethod beschreibt, wie die Debug-Engine mit dem Debuggen dieses Prozesses begonnen hat.

EngineSettings: DkmEngineSettings

[In] Enthält die sitzungsweiten Debugeinstellungen. Es gibt eine instance dieses Objekts pro Engine-Guid (z. B. eine instance für COMPlusOnlyEng2, eine instance für COMPlusNativeEng).

DebugLaunchSettings: DkmDebugLaunchSettings

[In] Einstellungen, die während eines Startdebuggingvorgangs von einem Projektsystem oder einem anderen Aufrufer von LaunchDebugTargets (oder verschiedenen anderen Startdebugging-APIs) bereitgestellt werden.

SystemInformation: DkmSystemInformation

[In] Enthält Informationen zum Computersystem, unter dem dieser Prozess ausgeführt wird. Wenn dieser Prozess unter WOW (32-Bit-Emulation auf einem 64-Bit-Betriebssystem) ausgeführt wird, gelten diese Informationen für das 32-Bit-Subsystem und nicht für das 64-Bit-Subsystem.

BaseDebugMonitorId: Guid

[In] DkmBaseDebugMonitorId identifiziert den Basisdebugmonitor, der zum Überprüfen und Steuern des debuggten Prozesses verwendet wird. Beispielsweise wird DkmBaseDebugMonitorId.WindowsProcess für Prozesse verwendet, die von der Win32-Debug-API debuggen, und DkmBaseDebugMonitorId.DumpFile wird für Minidumps verwendet.

IsAppPackage: Boolean

[In] True, wenn der Prozess zu einem Windows Store-App-Paket oder Windows Phone App-Paket gehört.

IsMultiArch: Boolean

[In] True, wenn der Prozess Code aus mehreren Architekturen enthält.

IsNativeDebuggingEnabled: Boolean

[In] Wenn true, versucht der Debugger, nativen Code zu debuggen. Er beendet native Ausnahmen, lädt Symbole, zeigt systemeigene Frames auf der Aufrufliste an, bindet und trifft Haltepunkte und lässt native Threads im Unterbrechungszustand beendet.

Live: DkmProcess.Live

[In,Optional] Informationen, die für einen ausgeführten Prozess relevant sind. Dieser Teil ist beispielsweise nicht für Minidumps vorhanden.

DataItem: DkmDataItem

[In,Optional] Datenobjekt, das dem neuen DkmProcess-instance hinzugefügt werden soll. Übergeben Sie "null", falls der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmProcess

[Out] Ergebnis dieses Methodenaufrufs.

Gilt für:

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, Boolean, DkmProcess+Live, DkmDataItem)

Diese Methode sendet ein ProcessCreate-Ereignis.

Standorteinschränkung: Die API muss von einer Monitor-Komponente aufgerufen werden (Komponentenebene < 100.000).

Diese API wurde in Visual Studio 12 RTM (DkmApiVersion.VS12RTM) eingeführt.

public:
 static Microsoft::VisualStudio::Debugger::DkmProcess ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, Guid UniqueId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::DefaultPort::DkmSystemInformation ^ SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft::VisualStudio::Debugger::DkmProcess::Live ^ Live, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.DkmProcess Create(Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live Live, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);

public static Microsoft.VisualStudio.Debugger.DkmProcess Create(Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsAppPackage, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess

Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsAppPackage As Boolean, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess

Parameter

Connection: DkmTransportConnection

Path: String

[In] Vollständiger Pfad zur ausführbaren Startdatei des Prozesses.

UniqueId: Guid

StartMethod: DkmStartMethod

[In] StartMethod beschreibt, wie die Debug-Engine mit dem Debuggen dieses Prozesses begonnen hat.

EngineSettings: DkmEngineSettings

[In] Enthält die sitzungsweiten Debugeinstellungen. Es gibt eine instance dieses Objekts pro Engine-Guid (z. B. eine instance für COMPlusOnlyEng2, eine instance für COMPlusNativeEng).

DebugLaunchSettings: DkmDebugLaunchSettings

SystemInformation: DkmSystemInformation

BaseDebugMonitorId: Guid

IsAppPackage: Boolean

[In] True, wenn der Prozess zu einem Windows Store-App-Paket oder Windows Phone App-Paket gehört.

IsNativeDebuggingEnabled: Boolean

Live: DkmProcess.Live

[In,Optional] Informationen, die für einen ausgeführten Prozess relevant sind. Dieser Teil ist beispielsweise nicht für Minidumps vorhanden.

DataItem: DkmDataItem

[In,Optional] Datenobjekt, das dem neuen DkmProcess-instance hinzugefügt werden soll. Übergeben Sie "null", falls der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmProcess

[Out] Ergebnis dieses Methodenaufrufs.

Gilt für:

Create(DkmTransportConnection, String, Guid, DkmStartMethod, DkmEngineSettings, DkmDebugLaunchSettings, DkmSystemInformation, Guid, Boolean, DkmProcess+Live, DkmDataItem)

Erstellt ein neues Prozessobjekt. Diese Methode wird im Rahmen der Verarbeitung von IDkmStartDebuggingOperations.AttachToProcess oder IDkmStartDebuggingOperations.ResumeDebuggedProcess vom Basisdebugging-Monitor im Ereignisthread aufgerufen.

Diese Methode sendet ein ProcessCreate-Ereignis.

Standorteinschränkung: Die API muss von einer Monitor-Komponente (Komponentenebene < 100.000) aufgerufen werden.

public:
 static Microsoft::VisualStudio::Debugger::DkmProcess ^ Create(Microsoft::VisualStudio::Debugger::DefaultPort::DkmTransportConnection ^ Connection, System::String ^ Path, Guid UniqueId, Microsoft::VisualStudio::Debugger::Start::DkmStartMethod StartMethod, Microsoft::VisualStudio::Debugger::DkmEngineSettings ^ EngineSettings, Microsoft::VisualStudio::Debugger::Start::DkmDebugLaunchSettings ^ DebugLaunchSettings, Microsoft::VisualStudio::Debugger::DefaultPort::DkmSystemInformation ^ SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft::VisualStudio::Debugger::DkmProcess::Live ^ Live, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);

public static Microsoft.VisualStudio.Debugger.DkmProcess Create(Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live Live, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);

public static Microsoft.VisualStudio.Debugger.DkmProcess Create(Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection Connection, string Path, Guid UniqueId, Microsoft.VisualStudio.Debugger.Start.DkmStartMethod StartMethod, Microsoft.VisualStudio.Debugger.DkmEngineSettings EngineSettings, Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings DebugLaunchSettings, Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation SystemInformation, Guid BaseDebugMonitorId, bool IsNativeDebuggingEnabled, Microsoft.VisualStudio.Debugger.DkmProcess.Live? Live, Microsoft.VisualStudio.Debugger.DkmDataItem? DataItem);

static member Create : Microsoft.VisualStudio.Debugger.DefaultPort.DkmTransportConnection * string * Guid * Microsoft.VisualStudio.Debugger.Start.DkmStartMethod * Microsoft.VisualStudio.Debugger.DkmEngineSettings * Microsoft.VisualStudio.Debugger.Start.DkmDebugLaunchSettings * Microsoft.VisualStudio.Debugger.DefaultPort.DkmSystemInformation * Guid * bool * Microsoft.VisualStudio.Debugger.DkmProcess.Live * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.DkmProcess

Public Shared Function Create (Connection As DkmTransportConnection, Path As String, UniqueId As Guid, StartMethod As DkmStartMethod, EngineSettings As DkmEngineSettings, DebugLaunchSettings As DkmDebugLaunchSettings, SystemInformation As DkmSystemInformation, BaseDebugMonitorId As Guid, IsNativeDebuggingEnabled As Boolean, Live As DkmProcess.Live, DataItem As DkmDataItem) As DkmProcess

Parameter

Connection: DkmTransportConnection

Path: String

[In] Vollständiger Pfad zur ausführbaren Startdatei des Prozesses.

UniqueId: Guid

StartMethod: DkmStartMethod

[In] StartMethod beschreibt, wie die Debug-Engine mit dem Debuggen dieses Prozesses begonnen hat.

EngineSettings: DkmEngineSettings

[In] Enthält die sitzungsweiten Debugeinstellungen. Es gibt eine instance dieses Objekts pro Engine-Guid (z. B. eine instance für COMPlusOnlyEng2, eine instance für COMPlusNativeEng).

DebugLaunchSettings: DkmDebugLaunchSettings

SystemInformation: DkmSystemInformation

BaseDebugMonitorId: Guid

IsNativeDebuggingEnabled: Boolean

Live: DkmProcess.Live

[In,Optional] Informationen, die für einen ausgeführten Prozess relevant sind. Dieser Teil ist beispielsweise nicht für Minidumps vorhanden.

DataItem: DkmDataItem

[In,Optional] Datenobjekt, das dem neuen DkmProcess-instance hinzugefügt werden soll. Übergeben Sie "null", falls der Aufrufer kein Datenelement hinzufügen muss.

Gibt zurück

DkmProcess

[Out] Ergebnis dieses Methodenaufrufs.

Gilt für: