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
Окне Дкмпроцесс представляет целевой процесс, который отлаживается. Отладчик выполняет обработку ошибок, поэтому это основная единица отладки. Дкмпроцесс может представлять системный процесс или виртуальный процесс, например Мини-дампы.
Окне Определяет объект Дкмрунтимеинстанце внутри процесса.
- CORSystemDirectory
- String
[Входные, необязательные] Каталог установки экземпляра среды CLR. Например, "c:\Windows\Microsoft.NET\Framework\v2.0.50727 ' . Это тот же путь, который возвращается из API GetCORSystemDirectory и всегда включает замыкающую косую черту.
- RuntimeVersion
- String
[Входные, необязательные] Строка версии для экземпляра CLR (например, "v 2.0.50727").
- DataItem
- DkmDataItem
[Входные, необязательные] Объект данных, добавляемый в новый экземпляр Дкмклррунтимеинстанце. Передайте значение NULL в случае, если вызывающему объекту не нужно добавлять элемент данных.
Возвращаемое значение
Заполняет Результат вызова этого метода.
Применяется к
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
Окне Дкмпроцесс представляет целевой процесс, который отлаживается. Отладчик выполняет обработку ошибок, поэтому это основная единица отладки. Дкмпроцесс может представлять системный процесс или виртуальный процесс, например Мини-дампы.
Окне Определяет объект Дкмрунтимеинстанце внутри процесса.
- 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 в случае, если вызывающему объекту не нужно добавлять элемент данных.
Возвращаемое значение
Заполняет Результат вызова этого метода.