DkmClrRuntimeInstance.Create Método

Definição

Sobrecargas

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

Cria um novo objeto de instância de tempo de execução a partir de um monitor de depuração. Esse método deve ser chamado a partir do thread de eventos quando um monitor de depuração detectar que uma nova instância de tempo de execução foi carregada (por exemplo, quando a DLL de tempo de execução correspondente for carregada no processo de destino).

Esse método enviará um evento RuntimeInstanceLoad.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

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

Cria um novo objeto de instância de tempo de execução a partir de um monitor de depuração. Esse método deve ser chamado a partir do thread de eventos quando um monitor de depuração detectar que uma nova instância de tempo de execução foi carregada (por exemplo, quando a DLL de tempo de execução correspondente for carregada no processo de destino).

Esse método enviará um evento RuntimeInstanceLoad.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion. VS12RTM).

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

Cria um novo objeto de instância de tempo de execução a partir de um monitor de depuração. Esse método deve ser chamado a partir do thread de eventos quando um monitor de depuração detectar que uma nova instância de tempo de execução foi carregada (por exemplo, quando a DLL de tempo de execução correspondente for carregada no processo de destino).

Esse método enviará um evento RuntimeInstanceLoad.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 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

Parâmetros

Process
DkmProcess

No DkmProcess representa um processo de destino que está sendo depurado. O depurador debugs processa, portanto, essa é a unidade básica de depuração. Um DkmProcess pode representar um processo do sistema ou um processo virtual, como minidespejos.

Id
DkmRuntimeInstanceId

No Identifica um objeto DkmRuntimeInstance dentro de um processo.

CORSystemDirectory
String

[In, opcional] O diretório de instalação da instância do Common Language Runtime (CLR). Por exemplo, ' c:\Windows\Microsoft.NET\Framework\v2.0.50727 ' . Esse é o mesmo caminho retornado da API GetCORSystemDirectory e sempre inclui a barra à direita.

RuntimeVersion
String

[In, opcional] A cadeia de caracteres da versão para a instância do CLR (por exemplo: ' v 2.0.50727 ').

DataItem
DkmDataItem

[In, opcional] Objeto de dados a ser adicionado à nova instância de DkmClrRuntimeInstance. Passe ' NULL ' caso o chamador não precise adicionar um item de dados.

Retornos

DkmClrRuntimeInstance

Fora Resultado dessa chamada de método.

Aplica-se a

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

Cria um novo objeto de instância de tempo de execução a partir de um monitor de depuração. Esse método deve ser chamado a partir do thread de eventos quando um monitor de depuração detectar que uma nova instância de tempo de execução foi carregada (por exemplo, quando a DLL de tempo de execução correspondente for carregada no processo de destino).

Esse método enviará um evento RuntimeInstanceLoad.

Restrição de local: a API deve ser chamada de um componente de monitor (nível de componente < 100.000).

Essa API foi introduzida no Visual Studio 12 RTM (DkmApiVersion. 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

Parâmetros

Process
DkmProcess

No DkmProcess representa um processo de destino que está sendo depurado. O depurador debugs processa, portanto, essa é a unidade básica de depuração. Um DkmProcess pode representar um processo do sistema ou um processo virtual, como minidespejos.

Id
DkmRuntimeInstanceId

No Identifica um objeto DkmRuntimeInstance dentro de um processo.

Capabilities
DkmRuntimeCapabilities

No Enumeração de recursos de tempo de execução.

ParentRuntime
DkmRuntimeInstance

[In, opcional] Para tempos de execução que são implementados sobre outro tempo de execução, opcionalmente, isso pode ser usado para o Índico do pai lógico. Isso pode ser usado para solicitar serviços do pai quando o tempo de execução filho não implementa o serviço. Atualmente, isso é usado apenas para obter o quadro de pilha superior para avaliar um ponto de interrupção condicional quando o tempo de execução filho não percorre as pilhas em si.

CORSystemDirectory
String

[In, opcional] O diretório de instalação da instância do Common Language Runtime (CLR). Por exemplo, ' c:\Windows\Microsoft.NET\Framework\v2.0.50727 ' . Esse é o mesmo caminho retornado da API GetCORSystemDirectory e sempre inclui a barra à direita.

RuntimeVersion
String

[In, opcional] A cadeia de caracteres da versão para a instância do CLR (por exemplo: ' v 2.0.50727 ').

DataItem
DkmDataItem

[In, opcional] Objeto de dados a ser adicionado à nova instância de DkmClrRuntimeInstance. Passe ' NULL ' caso o chamador não precise adicionar um item de dados.

Retornos

DkmClrRuntimeInstance

Fora Resultado dessa chamada de método.

Aplica-se a