DkmClrRuntimeInstance.Create Метод

Определение

Перегрузки

Create(DkmProcess, DkmRuntimeInstanceId, String, String, DkmDataItem)

Создает новый объект экземпляра среды выполнения из монитора отладки. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).

Этот метод будет отсылать событие Рунтимеинстанцелоад.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).

Create(DkmProcess, DkmRuntimeInstanceId, DkmRuntimeCapabilities, DkmRuntimeInstance, String, String, DkmDataItem)

Создает новый объект экземпляра среды выполнения из монитора отладки. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).

Этот метод будет отсылать событие Рунтимеинстанцелоад.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).

Этот API появился в Visual Studio 12 RTM (Дкмапиверсион. VS12RTM).

Create(DkmProcess, DkmRuntimeInstanceId, String, String, DkmDataItem)

Создает новый объект экземпляра среды выполнения из монитора отладки. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).

Этот метод будет отсылать событие Рунтимеинстанцелоад.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).

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

Окне Дкмпроцесс представляет целевой процесс, который отлаживается. Отладчик выполняет обработку ошибок, поэтому это основная единица отладки. Дкмпроцесс может представлять системный процесс или виртуальный процесс, например Мини-дампы.

Id
DkmRuntimeInstanceId

Окне Определяет объект Дкмрунтимеинстанце внутри процесса.

CORSystemDirectory
String

[Входные, необязательные] Каталог установки экземпляра среды CLR. Например, "c:\Windows\Microsoft.NET\Framework\v2.0.50727 ' . Это тот же путь, который возвращается из API GetCORSystemDirectory и всегда включает замыкающую косую черту.

RuntimeVersion
String

[Входные, необязательные] Строка версии для экземпляра CLR (например, "v 2.0.50727").

DataItem
DkmDataItem

[Входные, необязательные] Объект данных, добавляемый в новый экземпляр Дкмклррунтимеинстанце. Передайте значение NULL в случае, если вызывающему объекту не нужно добавлять элемент данных.

Возвращаемое значение

DkmClrRuntimeInstance

Заполняет Результат вызова этого метода.

Применяется к

Create(DkmProcess, DkmRuntimeInstanceId, DkmRuntimeCapabilities, DkmRuntimeInstance, String, String, DkmDataItem)

Создает новый объект экземпляра среды выполнения из монитора отладки. Этот метод должен вызываться из потока событий, когда монитор отладки обнаруживает, что новый экземпляр среды выполнения загружен (например, когда соответствующая DLL-библиотека среды выполнения загружается в целевой процесс).

Этот метод будет отсылать событие Рунтимеинстанцелоад.

Ограничение расположения: API должен вызываться из компонента монитора (уровень компонентов < 100 000).

Этот 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

Окне Дкмпроцесс представляет целевой процесс, который отлаживается. Отладчик выполняет обработку ошибок, поэтому это основная единица отладки. Дкмпроцесс может представлять системный процесс или виртуальный процесс, например Мини-дампы.

Id
DkmRuntimeInstanceId

Окне Определяет объект Дкмрунтимеинстанце внутри процесса.

Capabilities
DkmRuntimeCapabilities

Окне Перечисление возможностей среды выполнения.

ParentRuntime
DkmRuntimeInstance

[Входные, необязательные] Для сред выполнения, реализованных поверх другой среды выполнения, при необходимости можно использовать для индикант логического родителя. Затем он может использоваться для запроса служб от родительского объекта, когда дочерняя среда выполнения не реализует службу. В настоящее время этот параметр используется только для получения верхнего кадра стека, чтобы оценить условную точку останова, когда дочерняя среда выполнения не просматривает саму себя в стеке.

CORSystemDirectory
String

[Входные, необязательные] Каталог установки экземпляра среды CLR. Например, "c:\Windows\Microsoft.NET\Framework\v2.0.50727 ' . Это тот же путь, который возвращается из API GetCORSystemDirectory и всегда включает замыкающую косую черту.

RuntimeVersion
String

[Входные, необязательные] Строка версии для экземпляра CLR (например, "v 2.0.50727").

DataItem
DkmDataItem

[Входные, необязательные] Объект данных, добавляемый в новый экземпляр Дкмклррунтимеинстанце. Передайте значение NULL в случае, если вызывающему объекту не нужно добавлять элемент данных.

Возвращаемое значение

DkmClrRuntimeInstance

Заполняет Результат вызова этого метода.

Применяется к