DkmClrRuntimeInstance.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
| Create(DkmProcess, DkmRuntimeInstanceId, String, String, DkmDataItem) |
从调试监视器创建新的运行时实例对象。 当调试监视器检测到新的运行时实例已加载 (例如,在目标进程中加载相应的运行时 dll 时,必须从事件线程调用此方法) 。 此方法将发送 RuntimeInstanceLoad 事件。 位置约束:必须从监视器组件 (组件级别 100000) 中调用 API < 。 |
| Create(DkmProcess, DkmRuntimeInstanceId, DkmRuntimeCapabilities, DkmRuntimeInstance, String, String, DkmDataItem) |
从调试监视器创建新的运行时实例对象。 当调试监视器检测到新的运行时实例已加载 (例如,在目标进程中加载相应的运行时 dll 时,必须从事件线程调用此方法) 。 此方法将发送 RuntimeInstanceLoad 事件。 位置约束:必须从监视器组件 (组件级别 100000) 中调用 API < 。 此 API 是在 Visual Studio 12 RTM (VS12RTM) 中引入的。 |
Create(DkmProcess, DkmRuntimeInstanceId, String, String, DkmDataItem)
从调试监视器创建新的运行时实例对象。 当调试监视器检测到新的运行时实例已加载 (例如,在目标进程中加载相应的运行时 dll 时,必须从事件线程调用此方法) 。
此方法将发送 RuntimeInstanceLoad 事件。
位置约束:必须从监视器组件 (组件级别 100000) 中调用 API < 。
public:
static Microsoft::VisualStudio::Debugger::Clr::DkmClrRuntimeInstance ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, Microsoft::VisualStudio::Debugger::DkmRuntimeInstanceId Id, System::String ^ CORSystemDirectory, System::String ^ RuntimeVersion, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId Id, string CORSystemDirectory, string RuntimeVersion, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId * string * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance
Public Shared Function Create (Process As DkmProcess, Id As DkmRuntimeInstanceId, CORSystemDirectory As String, RuntimeVersion As String, DataItem As DkmDataItem) As DkmClrRuntimeInstance
参数
- Process
- DkmProcess
中DkmProcess 表示正在调试的目标进程。 调试器调试进程,因此这是调试的基本单元。 DkmProcess 可以表示系统进程或虚拟进程,如小型转储。
中标识进程中的 DkmRuntimeInstance 对象。
- CORSystemDirectory
- String
[In,可选]公共语言运行时的安装目录 (CLR) 实例。 例如 "c:\Windows\Microsoft.NET\Framework\v2.0.50727" ' 。 这是从 GetCORSystemDirectory API 返回的同一路径,并且它始终包含尾随斜杠。
- RuntimeVersion
- String
[In,可选]CLR 实例的版本字符串 (例如: "2.0.50727" ) 。
- DataItem
- DkmDataItem
[In,可选]要添加到新的 DkmClrRuntimeInstance 实例的数据对象。 如果调用方不需要添加数据项,则传递 "null"。
返回
弄此方法调用的结果。
适用于
Create(DkmProcess, DkmRuntimeInstanceId, DkmRuntimeCapabilities, DkmRuntimeInstance, String, String, DkmDataItem)
从调试监视器创建新的运行时实例对象。 当调试监视器检测到新的运行时实例已加载 (例如,在目标进程中加载相应的运行时 dll 时,必须从事件线程调用此方法) 。
此方法将发送 RuntimeInstanceLoad 事件。
位置约束:必须从监视器组件 (组件级别 100000) 中调用 API < 。
此 API 是在 Visual Studio 12 RTM (VS12RTM) 中引入的。
public:
static Microsoft::VisualStudio::Debugger::Clr::DkmClrRuntimeInstance ^ Create(Microsoft::VisualStudio::Debugger::DkmProcess ^ Process, Microsoft::VisualStudio::Debugger::DkmRuntimeInstanceId Id, Microsoft::VisualStudio::Debugger::DkmRuntimeCapabilities Capabilities, Microsoft::VisualStudio::Debugger::DkmRuntimeInstance ^ ParentRuntime, System::String ^ CORSystemDirectory, System::String ^ RuntimeVersion, Microsoft::VisualStudio::Debugger::DkmDataItem ^ DataItem);
public static Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance Create (Microsoft.VisualStudio.Debugger.DkmProcess Process, Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId Id, Microsoft.VisualStudio.Debugger.DkmRuntimeCapabilities Capabilities, Microsoft.VisualStudio.Debugger.DkmRuntimeInstance ParentRuntime, string CORSystemDirectory, string RuntimeVersion, Microsoft.VisualStudio.Debugger.DkmDataItem DataItem);
static member Create : Microsoft.VisualStudio.Debugger.DkmProcess * Microsoft.VisualStudio.Debugger.DkmRuntimeInstanceId * Microsoft.VisualStudio.Debugger.DkmRuntimeCapabilities * Microsoft.VisualStudio.Debugger.DkmRuntimeInstance * string * string * Microsoft.VisualStudio.Debugger.DkmDataItem -> Microsoft.VisualStudio.Debugger.Clr.DkmClrRuntimeInstance
Public Shared Function Create (Process As DkmProcess, Id As DkmRuntimeInstanceId, Capabilities As DkmRuntimeCapabilities, ParentRuntime As DkmRuntimeInstance, CORSystemDirectory As String, RuntimeVersion As String, DataItem As DkmDataItem) As DkmClrRuntimeInstance
参数
- Process
- DkmProcess
中DkmProcess 表示正在调试的目标进程。 调试器调试进程,因此这是调试的基本单元。 DkmProcess 可以表示系统进程或虚拟进程,如小型转储。
中标识进程中的 DkmRuntimeInstance 对象。
- Capabilities
- DkmRuntimeCapabilities
中运行时功能的枚举。
- ParentRuntime
- DkmRuntimeInstance
[In,可选]对于在另一个运行时之上实现的运行时,可以选择使用它来 indicant 逻辑父级。 如果子运行时未实现服务,则可以使用此项从父运行时请求服务。 此值当前仅用于获取顶部堆栈帧,以便在子运行时不遍历自身时计算条件断点。
- CORSystemDirectory
- String
[In,可选]公共语言运行时的安装目录 (CLR) 实例。 例如 "c:\Windows\Microsoft.NET\Framework\v2.0.50727" ' 。 这是从 GetCORSystemDirectory API 返回的同一路径,并且它始终包含尾随斜杠。
- RuntimeVersion
- String
[In,可选]CLR 实例的版本字符串 (例如: "2.0.50727" ) 。
- DataItem
- DkmDataItem
[In,可选]要添加到新的 DkmClrRuntimeInstance 实例的数据对象。 如果调用方不需要添加数据项,则传递 "null"。
返回
弄此方法调用的结果。