DkmProcess.Create 方法

定义

重载

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

创建新的进程对象。 在 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 的处理过程中,从事件线程上的基本调试监视器调用此方法。

此方法将发送 ProcessCreate 事件。

位置约束:必须从监视组件 (组件级别 < 100,000) 调用 API。

此 API 是在 Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) 中引入的。

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

创建新的进程对象。 在 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 的处理过程中,从事件线程上的基本调试监视器调用此方法。

此方法将发送 ProcessCreate 事件。

位置约束:必须从监视组件 (组件级别 < 100,000) 调用 API。

此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。

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

创建新的进程对象。 在 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 的处理过程中,从事件线程上的基本调试监视器调用此方法。

此方法将发送 ProcessCreate 事件。

位置约束:必须从监视组件 (组件级别 < 100,000) 调用 API。

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

创建新的进程对象。 在 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 的处理过程中,从事件线程上的基本调试监视器调用此方法。

此方法将发送 ProcessCreate 事件。

位置约束:必须从监视组件 (组件级别 < 100,000) 调用 API。

此 API 是在 Visual Studio 16 Update 9 (DkmApiVersion.VS16Update9) 中引入的。

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

参数

Connection
DkmTransportConnection

[In]这表示监视器与 IDE 之间的连接。 如果监视器与 IDE 在同一进程中运行,则它可以是本地连接,也可以是远程连接。 在监视过程中,只有一个连接。

Path
String

[In]进程起始可执行文件的完整路径。

UniqueId
Guid

[In]唯一标识此进程对象的 Guid。 此 Guid 值与在 SDM 层 (IDebugProcess2::GetProcessId) 和自动化层公开的 Guid 相同。

StartMethod
DkmStartMethod

[In]StartMethod 描述调试引擎如何开始调试此过程。

EngineSettings
DkmEngineSettings

[In]包含会话范围的调试设置。 每个引擎 Guid (有一个此对象的实例,例如:一个实例用于 COMPlusOnlyEng2,一个实例用于 COMPlusNativeEng) 。

DebugLaunchSettings
DkmDebugLaunchSettings

[In]启动调试操作期间从项目系统或 LaunchDebugTargets 的其他调用方 (或其他各种启动调试 API) 提供的设置。

SystemInformation
DkmSystemInformation

[In]包含有关运行此进程的计算机系统的信息。 如果此过程在 WOW (64 位操作系统上的 32 位仿真下运行) 则此信息将针对 32 位子系统而不是 64 位子系统。

BaseDebugMonitorId
Guid

[In]DkmBaseDebugMonitorId 标识用于检查和控制调试进程的基本调试监视器。 例如,DkmBaseDebugMonitorId.WindowsProcess 用于由 Win32 调试 API 调试的进程,DkmBaseDebugMonitorId.DumpFile 用于 minidumps。

IsAppPackage
Boolean

[In]如果进程属于 Windows 应用商店应用包或Windows Phone应用包,则其值为 True。

IsMultiArch
Boolean

[In]如果进程包含来自多个体系结构的代码,则为 True。

IsNativeDebuggingEnabled
Boolean

[In]如果为 true,调试器将尝试调试本机代码 - 它将在本机异常时停止,加载符号,在调用堆栈上显示本机帧,绑定和命中断点,并在处于中断状态时使本机线程停止。

Live
DkmProcess.Live

[In,Optional]与正在运行的进程相关的信息。 例如,此部件将不用于小型转送。

DataItem
DkmDataItem

[In,Optional]要添加到新 DkmProcess 实例的数据对象。 如果调用方不需要添加数据项,则传递“null”。

返回

[Out]此方法调用的结果。

适用于

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

创建新的进程对象。 在 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 的处理过程中,从事件线程上的基本调试监视器调用此方法。

此方法将发送 ProcessCreate 事件。

位置约束:必须从监视组件 (组件级别 < 100,000) 调用 API。

此 API 是在 Visual Studio 12 RTM (DkmApiVersion.VS12RTM) 中引入的。

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

参数

Connection
DkmTransportConnection

[In]这表示监视器与 IDE 之间的连接。 如果监视器与 IDE 在同一进程中运行,则它可以是本地连接,也可以是远程连接。 在监视过程中,只有一个连接。

Path
String

[In]进程起始可执行文件的完整路径。

UniqueId
Guid

[In]唯一标识此进程对象的 Guid。 此 Guid 值与在 SDM 层 (IDebugProcess2::GetProcessId) 和自动化层公开的 Guid 相同。

StartMethod
DkmStartMethod

[In]StartMethod 描述调试引擎如何开始调试此过程。

EngineSettings
DkmEngineSettings

[In]包含会话范围的调试设置。 每个引擎 Guid (有一个此对象的实例,例如:一个实例用于 COMPlusOnlyEng2,一个实例用于 COMPlusNativeEng) 。

DebugLaunchSettings
DkmDebugLaunchSettings

[In]启动调试操作期间从项目系统或 LaunchDebugTargets 的其他调用方 (或其他各种启动调试 API) 提供的设置。

SystemInformation
DkmSystemInformation

[In]包含有关运行此进程的计算机系统的信息。 如果此过程在 WOW (64 位操作系统上的 32 位仿真下运行) 则此信息将针对 32 位子系统而不是 64 位子系统。

BaseDebugMonitorId
Guid

[In]DkmBaseDebugMonitorId 标识用于检查和控制调试进程的基本调试监视器。 例如,DkmBaseDebugMonitorId.WindowsProcess 用于由 Win32 调试 API 调试的进程,DkmBaseDebugMonitorId.DumpFile 用于 minidumps。

IsAppPackage
Boolean

[In]如果进程属于 Windows 应用商店应用包或Windows Phone应用包,则其值为 True。

IsNativeDebuggingEnabled
Boolean

[In]如果为 true,调试器将尝试调试本机代码 - 它将在本机异常时停止,加载符号,在调用堆栈上显示本机帧,绑定和命中断点,并在处于中断状态时使本机线程停止。

Live
DkmProcess.Live

[In,Optional]与正在运行的进程相关的信息。 例如,此部件将不用于小型转送。

DataItem
DkmDataItem

[In,Optional]要添加到新 DkmProcess 实例的数据对象。 如果调用方不需要添加数据项,则传递“null”。

返回

[Out]此方法调用的结果。

适用于

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

创建新的进程对象。 在处理 IDkmStartDebuggingOperations.AttachToProcess 或 IDkmStartDebuggingOperations.ResumeDebuggedProcess 时,从事件线程上的基本调试监视器调用此方法。

此方法将发送 ProcessCreate 事件。

位置约束:必须从监视组件 (组件级别 < 100,000) 调用 API。

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

参数

Connection
DkmTransportConnection

[In]这表示监视器与 IDE 之间的连接。 如果监视器与 IDE 在同一进程中运行,则它可以是本地连接,也可以是远程连接。 在监视过程中,只有一个连接。

Path
String

[In]进程起始可执行文件的完整路径。

UniqueId
Guid

[In]唯一标识此进程对象的 Guid。 此 Guid 值与在 SDM 层 (IDebugProcess2::GetProcessId) 和自动化层公开的 Guid 相同。

StartMethod
DkmStartMethod

[In]StartMethod 描述调试引擎如何开始调试此过程。

EngineSettings
DkmEngineSettings

[In]包含会话范围的调试设置。 每个引擎 Guid (有一个此对象的实例,例如:一个实例用于 COMPlusOnlyEng2,一个实例用于 COMPlusNativeEng) 。

DebugLaunchSettings
DkmDebugLaunchSettings

[In]启动调试操作期间从项目系统或 LaunchDebugTargets 的其他调用方 (或其他各种启动调试 API) 提供的设置。

SystemInformation
DkmSystemInformation

[In]包含有关运行此进程的计算机系统的信息。 如果此过程在 WOW (64 位操作系统上的 32 位仿真下运行) 则此信息将针对 32 位子系统而不是 64 位子系统。

BaseDebugMonitorId
Guid

[In]DkmBaseDebugMonitorId 标识用于检查和控制调试进程的基本调试监视器。 例如,DkmBaseDebugMonitorId.WindowsProcess 用于由 Win32 调试 API 调试的进程,DkmBaseDebugMonitorId.DumpFile 用于 minidumps。

IsNativeDebuggingEnabled
Boolean

[In]如果为 true,调试器将尝试调试本机代码 - 它将在本机异常时停止,加载符号,在调用堆栈上显示本机帧,绑定和命中断点,并在处于中断状态时使本机线程停止。

Live
DkmProcess.Live

[In,Optional]与正在运行的进程相关的信息。 例如,此部件将不用于小型转送。

DataItem
DkmDataItem

[In,Optional]要添加到新 DkmProcess 实例的数据对象。 如果调用方不需要添加数据项,则传递“null”。

返回

[Out]此方法调用的结果。

适用于