Compartilhar via


DkmClrModuleInstance Classe

Definição

'DkmClrModuleInstance' é usado para módulos carregados no Common Language Runtime.

Classes derivadas: DkmClrNcModuleInstance

public ref class DkmClrModuleInstance : Microsoft::VisualStudio::Debugger::DkmModuleInstance
[System.Runtime.InteropServices.Guid("29da4ffa-6063-6232-46dd-64d14cf56ddf")]
public class DkmClrModuleInstance : Microsoft.VisualStudio.Debugger.DkmModuleInstance
[<System.Runtime.InteropServices.Guid("29da4ffa-6063-6232-46dd-64d14cf56ddf")>]
type DkmClrModuleInstance = class
    inherit DkmModuleInstance
Public Class DkmClrModuleInstance
Inherits DkmModuleInstance
Herança
Herança
Derivado
Atributos

Propriedades

AppDomain

DkmClrAppDomain representa um domínio de aplicativo CLR dentro de um processo que está sendo depurado.

BaseAddress

[Opcional] O endereço de memória inicial de onde o módulo foi carregado. Esse valor será zero se o módulo não tiver sido carregado em um bloco contíguo de memória.

(Herdado de DkmModuleInstance)
ClrFlags

Sinalizadores que indicam características de um DkmModuleInstance que foi carregado pelo CLR.

Connection

Isso representa uma conexão entre o monitor e o IDE. Ele pode ser uma conexão local se o monitor estiver em execução no mesmo processo que o IDE ou pode ser uma conexão remota. No processo do monitor, há apenas uma conexão.

(Herdado de DkmModuleInstance)
Flags

Sinalizadores que indicam características de um DkmModuleInstance.

(Herdado de DkmModuleInstance)
FullName

Nome do módulo totalmente qualificado. Para módulos baseados em arquivo, esse é o caminho completo para o módulo (por exemplo: c:\windows\system32\kernel32.dll.

(Herdado de DkmModuleInstance)
ILImageSize

Especifica o tamanho da imagem IL deste módulo, pois ela se refere à pesquisa do servidor de símbolos. Para desktop .NET Framework, isso especificará o tamanho da imagem IL que será diferente do tamanho da imagem bruta no caso de ngen. Isso ocorre porque a imagem il somente é o que é indexado em Servidores de Símbolos. Para o ngen do .NET Core e pronto para execução, isso especificará o tamanho bruto da imagem como ngen/pronto para executar a imagem é o que é indexado e não queremos fazer pesquisa com base no tamanho da imagem somente IL.

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

IsDisabled

Indica se esta instância de módulo foi desabilitada. Os módulos desabilitados são amplamente ignorados pelo depurador. Para módulos nativos, o intervalo de endereços do módulo desabilitado é tratado como se não fosse mapeado. Para módulos CLR, todos os quadros desses módulos são ocultos da pilha de chamadas.

(Herdado de DkmModuleInstance)
IsUnloaded

Retornará true se um evento 'descarregado' tiver sido gerado para este objeto (exemplo: DkmThread::Unload for chamado) ou se o objeto tiver sido fechado. Observe que o cuidado deve ser usado ao verificar esse status, pois, sem sincronização, o status retornado pode não ser mais preciso após a leitura.

(Herdado de DkmDataContainer)
LoadContext

Descrição da cadeia de caracteres do contexto no qual este módulo foi carregado. ex: 'Win32' ou 'CLR v2.0.50727: Domínio Padrão'.

(Herdado de DkmModuleInstance)
LoadOrder

A contagem de inteiros do número de instâncias de módulo carregadas para e incluindo este módulo. Cada instância de runtime controla sua própria contagem de pedidos de carga.

(Herdado de DkmModuleInstance)
MemoryLayout

Enumeração que indica como um módulo é disposto na memória.

(Herdado de DkmModuleInstance)
MinidumpInfoPart

[Opcional] 'MinidumpInfoPart' é usado para transmitir informações adicionais sobre módulos em um DkmProcess para um minidump.

(Herdado de DkmModuleInstance)
Module

[Opcional] A representação do manipulador de símbolos de um módulo (DkmModule) que está associado a essa instância de módulo. Esse valor é inicialmente nulo e é atribuído se e quando os símbolos estão associados a essa instância de módulo.

(Herdado de DkmModuleInstance)
Mvid

Identificador de versão do módulo carregado. Esse é um valor exclusivo que é inserido em um exe/dll por vinculadores/compiladores quando a dll/exe é criada. Um novo valor é gerado sempre que a dll/exe é compilada.

Name

Representação curta do nome do módulo. Para módulos baseados em arquivo, esse é o nome do arquivo e a extensão (por exemplo: kernel32.dll).

(Herdado de DkmModuleInstance)
Process

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

(Herdado de DkmModuleInstance)
RuntimeInstance

Representa uma instância CLR em execução em um processo de destino.

Size

[Opcional] O número de bytes na região de memória do módulo. Esse valor será zero se o módulo não tiver sido carregado em um bloco contíguo de memória.

(Herdado de DkmModuleInstance)
SymbolFileId

[Opcional] Contém informações necessárias para localizar símbolos para este módulo. No Win32, essas informações estão contidas no IMAGE_DEBUG_DIRECTORY.

(Herdado de DkmModuleInstance)
TagValue

DkmModuleInstance é uma classe base abstrata. Essa enumeração indica de qual classe derivada esse objeto é uma instância do .

(Herdado de DkmModuleInstance)
TimeDateStamp

Data/hora de quando o módulo carregado foi criado. Esse valor é obtido do IMAGE_NT_HEADERS do módulo carregado. A unidade de medida é um valor FILETIME, que é um valor de 64 bits que representa o número de intervalos de 100 nanossegundos desde 1º de janeiro de 1601 (UTC).

(Herdado de DkmModuleInstance)
UniqueId

Identifica exclusivamente o objeto DkmModuleInstance.

(Herdado de DkmModuleInstance)
Version

[Opcional] Informações de versão do arquivo.

(Herdado de DkmModuleInstance)

Métodos

CanDecompileMethod(DkmClrMethodId)

Fornece informações sobre se o método especificado pode ou não ser descompilado.

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

Essa API foi introduzida no Visual Studio 17 Atualização 5 (DkmApiVersion.VS17Update5).

CanDecompileModule(DkmDecompilerMode)

Fornece informações sobre se o módulo pode ou não ser descompilado em um determinado modo.

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

Essa API foi introduzida no Visual Studio 17 Atualização 7 (DkmApiVersion.VS17Update7).

ClearTransitionModuleFlag()

Instâncias de runtime chamam esse método para marcar um módulo como um módulo de limite. Ao pisar, os runtimes devem marcar se a etapa atingiu um módulo de limite e começar a intervir na arbitragem, se tiverem. Observe que alguns runtimes podem não ser capazes de atender a essa solicitação. O dispatcher manterá uma contagem do número de vezes que FlagAsTransitionModule foi chamado. Somente quando um número correspondente de chamadas para ClearTransitionModuleFlag não for mais considerado um módulo de transição.

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

(Herdado de DkmModuleInstance)
Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Create uma nova instância de objeto DkmClrModuleInstance.

Esse método enviará um evento ModuleInstanceLoad.

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

Create(String, String, UInt64, DkmModuleVersion, DkmSymbolFileId, DkmModuleFlags, DkmModuleMemoryLayout, UInt64, UInt32, UInt32, String, DkmClrRuntimeInstance, Guid, DkmClrModuleFlags, DkmClrAppDomain, UInt32, Boolean, DkmModule, DkmModuleInstance+MinidumpInfo, DkmDataItem)

Create uma nova instância de objeto DkmClrModuleInstance.

Esse método enviará um evento ModuleInstanceLoad.

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

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

Decompile()

Descompila o código de um módulo em C# e cria um novo PDB portátil com essa fonte inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados.

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

Essa API foi introduzida no Visual Studio 16 Atualização 5 (DkmApiVersion.VS16Update5).

(Herdado de DkmModuleInstance)
Decompile(DkmDecompilerMode, String, Int32)

Descompila o código de um módulo em C# e cria um novo PDB portátil com essa fonte inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

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

Essa API foi introduzida no Visual Studio 17 Atualização 7 (DkmApiVersion.VS17Update7).

Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult>)

Descompila o código de um módulo em C# e cria um novo PDB portátil com essa fonte inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 16 Atualização 5 (DkmApiVersion.VS16Update5).

(Herdado de DkmModuleInstance)
Decompile(DkmWorkList, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Descompila o código de um módulo em C# e cria um novo PDB portátil com essa fonte inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 17 Atualização 3 (DkmApiVersion.VS17Update3).

(Herdado de DkmModuleInstance)
Decompile(DkmWorkList, DkmDecompilerMode, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Descompila o código de um módulo em C# e cria um novo PDB portátil com essa fonte inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 17 Atualização 7 (DkmApiVersion.VS17Update7).

Decompile(String, Int32)

Descompile o código de um módulo em C# e cria um novo PDB portátil com essa fonte inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

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

Essa API foi introduzida no Visual Studio 17 Atualização 3 (DkmApiVersion.VS17Update3).

(Herdado de DkmModuleInstance)
DecompileDocument(DkmWorkList, String, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Descompila o código de um documento em C# e atualiza o arquivo de símbolo associado ao módulo que contém com as informações de depuração necessárias e a origem inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 17 Atualização 5 (DkmApiVersion.VS17Update5).

DecompileDocument(String, String, Int32)

Descompila o código de um documento em C# e atualiza o arquivo de símbolo associado ao módulo que contém com as informações de depuração necessárias e a origem inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

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

Essa API foi introduzida no Visual Studio 17 Atualização 5 (DkmApiVersion.VS17Update5).

DecompileMethods(DkmWorkList, ReadOnlyCollection<DkmClrMethodId>, DkmCompletionRoutine<DkmDecompileAsyncResult173>)

Descompila o código dos métodos em C# e atualiza o arquivo de símbolo associado ao módulo que contém com as informações de depuração necessárias e a origem inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 17 Atualização 5 (DkmApiVersion.VS17Update5).

DecompileMethods(ReadOnlyCollection<DkmClrMethodId>, String, Int32)

Descompila o código dos métodos em C# e atualiza o arquivo de símbolo associado ao módulo que contém com as informações de depuração necessárias e a origem inserida. Todos os módulos que compartilham esse arquivo de símbolo começarão a usar esses símbolos atualizados. As implementações devem retornar S_OK em caso de falha e retornar o HRESULT real e quaisquer informações de erro adicionais por meio dos parâmetros 'HR' e 'ErrorMessage'.

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

Essa API foi introduzida no Visual Studio 17 Atualização 5 (DkmApiVersion.VS17Update5).

FlagAsTransitionModule()

As instâncias de runtime chamam esse método para marcar um módulo como um módulo de limite. Ao pisar, os runtimes devem marcar se a etapa atingiu um módulo de limite e começar a intervir na arbitragem se tiverem. Observe que alguns runtimes podem não ser capazes de atender a essa solicitação. O dispatcher manterá uma contagem do número de vezes que isso foi chamado. Somente quando um número correspondente de chamadas para ClearTransitionModuleFlag tiver sido feito, o módulo não será mais considerado um módulo de transição.

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

(Herdado de DkmModuleInstance)
GetBaselineMetaDataBytes()

Obtém os bytes de linha de base dos metadados CLR de um determinado módulo.

Essa API foi introduzida no Visual Studio 15 Atualização 5 (DkmApiVersion.VS15Update5).

GetBaselineMetaDataBytesPtr(UInt32)

Obtenha um ponteiro para os bytes de metadados brutos originais para o módulo fornecido.

Restrição de local: Nenhuma.

Essa API foi introduzida no Visual Studio 15 Atualização 5 (DkmApiVersion.VS15Update5).

GetCorObject()

Fornece acesso direto ao objeto ICorDebugModule, que avaliadores de expressão ou outros componentes podem usar para inspecionar o domínio do aplicativo.

A interface retornada só pode ser usada para inspecionar o processo de destino e NUNCA deve ser usada para controlar a execução (sem etapas, sem pontos de interrupção, sem continuar etc.). Isso não tem suporte e resultará em um comportamento indefinido.

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

GetDataItem<T>()

Obtém a instância de 'T' que foi adicionada a essa instância de contêiner. Se esse contêiner não contiver um 'T', essa função retornará nulo.

(Herdado de DkmDataContainer)
GetEncAvailability(String)

Verifica se Há suporte para Editar e Continuar para a instância do módulo gerenciado correspondente.

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

Essa API foi introduzida no Visual Studio 16 Atualização 1 (DkmApiVersion.VS16Update1).

GetEncILDelta(Int32)

Responsável por consultar o delta il associado a uma instância de módulo CLR. O delta il são os bytes resultantes de uma alteração de código, o que pode afetar vários métodos. Isso é consumido pelo VIL ao consultar informações sobre um método modificado em um módulo.

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

Essa API foi introduzida no Visual Studio 16 Atualização 3 (DkmApiVersion.VS16Update3).

GetGPUDisassembly(UInt64, UInt32, Boolean, Boolean)

Obtenha a desmontagem do intervalo de endereços na instância do módulo de depuração.

(Herdado de DkmModuleInstance)
GetGPUDisassemblySize()

Retorna o tamanho de desmontagem na instância do módulo de depuração.

(Herdado de DkmModuleInstance)
GetLocalSignatureToken(Int32)

Obtém o token de assinatura de uma assinatura de variável local dado um token de método.

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetMetaDataBytes()

Obtém os bytes dos metadados CLR de um determinado módulo. Esses bytes podem ser passados para IMetaDataDispenser::OpenScope para decodificar os metadados.

GetMetaDataBytesPtr(UInt32)

Obtenha um ponteiro para os bytes de metadados brutos para o módulo fornecido.

OBSERVAÇÃO: esse valor de ponteiro se tornará inválido se/quando o módulo for a) descarregado ou b) modificado. Para detectar esses cenários: a) Adicione um item de dados à instância do módulo. O ponteiro será inválido depois que o método OnClose for chamado (quando a instância do módulo for descarregada). b) Implemente IDkmClrModuleModifiedNotification.

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetMetaDataFileInfo(Boolean, UInt32, UInt32)

Obtém as informações necessárias para ler os metadados diretamente de um arquivo no disco.

Essa API foi introduzida no Visual Studio 16 Atualização 2 (DkmApiVersion.VS16Update2).

GetMetaDataImport()

Obtém os metadados CLR de um determinado módulo. Consulte a documentação IMetaDataImport no MSDN para obter mais informações sobre metadados.

OBSERVAÇÃO: os chamadores devem ter muito cuidado ao consumir essa API do código gerenciado. A implementação IMetaDataImport pode conter um identificador de arquivo para um arquivo de depuração e o identificador de arquivo só será fechado quando a contagem de referência COM atingir zero. Portanto, ele deve ser liberado manualmente (Marshal.IsComObject + Marshal.ReleaseComObject) em vez de esperar que o GC detecte que o objeto pode ser liberado. Ao testar, verifique se o arquivo de depuração tem pelo menos 64 KB de metadados, pois o leitor de metadados não manterá o arquivo bloqueado para leitura ao lidar com arquivos pequenos.

GetMetadataStatus()

Obter status de metadados.

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

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

GetMethodTokens(DkmWorkList, String, String, DkmCompletionRoutine<DkmGetMethodTokensAsyncResult>)

Fornece um mecanismo para obter tokens de metadados para um método fornecido por uma classe. Equivalente a IMetaDataImport::EnumMethodsWithName.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetMethodTokens(String, String, Int32[])

Fornece um mecanismo para obter tokens de metadados para um método fornecido por uma classe. Equivalente a IMetaDataImport::EnumMethodsWithName.

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

GetNextGPUInstructionAddress(UInt64)

Retorna o endereço da próxima instrução em relação a um endereço inicial.

(Herdado de DkmModuleInstance)
GetSymbolLoadInformation()

Retorna uma cadeia de caracteres que descreve os vários locais nos quais os símbolos foram pesquisados e o resultado da verificação desse local. Essas informações são usadas para preencher as 'Informações de Carregamento de Símbolo' na janela de módulos.

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

(Herdado de DkmModuleInstance)
GetSymbolSearchResult()

Recupera todos os resultados de pesquisa de símbolo associados a esta instância de módulo.

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

Essa API foi introduzida no Visual Studio 17 Atualização 3 (DkmApiVersion.VS17Update3).

(Herdado de DkmModuleInstance)
GetSymbolSearchResult(DkmWorkList, DkmCompletionRoutine<DkmGetSymbolSearchResultAsyncResult>)

Recupera todos os resultados de pesquisa de símbolo associados a esta instância de módulo.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 17 Atualização 3 (DkmApiVersion.VS17Update3).

(Herdado de DkmModuleInstance)
GetSymbolStatusMessage(Boolean)

Obtenha uma descrição de cadeia de caracteres localizada do símbolo atual status.

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

(Herdado de DkmModuleInstance)
GetSymbolStatusMessage(DkmWorkList, Boolean, DkmCompletionRoutine<DkmGetSymbolStatusMessageAsyncResult>)

Obtenha uma descrição de cadeia de caracteres localizada do símbolo atual status.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

(Herdado de DkmModuleInstance)
GetSymUnmanagedReader()

Essa API fornece uma implementação parcial de ISymUnmanagedReader2 para um módulo CLR.

Restrição de local: fornece uma implementação parcial de ISymUnmanagedReader2 para ambos os lados da conexão remota.

Essa API foi introduzida no Visual Studio 15 RTM (DkmApiVersion.VS15RTM).

GetTypeIdForTypeName(String)

Retorna a ID de tipo para um determinado nome de tipo.

Essa API foi introduzida no Visual Studio 17 Atualização 8 (DkmApiVersion.VS17Update8).

InterpretManagedMethod(DkmClrMethodId, ReadOnlyCollection<DkmClrType>, ReadOnlyCollection<DkmClrType>, DkmILInterpreterValue, ReadOnlyCollection<DkmILInterpreterValue>, Int32, DkmILInterpreterOptions, String)

Simula a execução de um método em um objeto interpretando o código MSIL do método. O resultado do método será retornado ao chamador. No entanto, ao contrário de uma avaliação de função, na qual o método está realmente em execução no destino, interpretar um método não realmente executa o método, mas, em vez disso, apenas simula o comportamento do método. Como o método nunca é realmente executado, quaisquer efeitos colaterais resultantes da execução do método são descartados após a conclusão da interpretação do método, deixando o processo de destino em um estado idêntico ao de antes da chamada.

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

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

IsSuppressed()

Esse método permite que um componente determine se o evento de carregamento do módulo para um módulo foi suprimido.

Essa API foi introduzida no Visual Studio 12 Atualização 3 (DkmApiVersion.VS12Update3).

(Herdado de DkmModuleInstance)
IsTransitionModule()

Retornará true se qualquer instância de runtime tiver sinalizado este módulo como um módulo de transição.

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

(Herdado de DkmModuleInstance)
IsUserCode()

Determina se um módulo é considerado código do usuário.

Restrição de localização: esse método pode ser chamado de um componente IDE. A partir do Visual Studio 2013 Atualização 2, também é possível chamá-lo de um componente de monitor para código gerenciado. No Visual Studio 2017 Atualização 8, o CallDirection da API foi feito 'Bidirecional' de 'Normal' e agora pode ser chamado de qualquer componente, AsyncCaller foi definido como 'true' e CallerLocationConstraint foi definido como 'None' de 'NoMarshalling'.

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

(Herdado de DkmModuleInstance)
IsUserCode(DkmWorkList, DkmCompletionRoutine<DkmModuleInstanceIsUserCodeAsyncResult>)

Determina se um módulo é considerado código do usuário.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de localização: esse método pode ser chamado de um componente IDE. A partir do Visual Studio 2013 Atualização 2, também é possível chamá-lo de um componente de monitor para código gerenciado. No Visual Studio 2017 Atualização 8, o CallDirection da API foi feito 'Bidirecional' de 'Normal' e agora pode ser chamado de qualquer componente, AsyncCaller foi definido como 'true' e CallerLocationConstraint foi definido como 'None' de 'NoMarshalling'.

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

(Herdado de DkmModuleInstance)
OnBinaryLoaded(String)

Gerar um evento BinaryLoaded. Os componentes que implementam a interface do coletor de eventos receberão a notificação de evento. O controle retornará depois que todos os componentes forem notificados.

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

(Herdado de DkmModuleInstance)
OnBinaryReloadOpportunity()

Gerar um evento BinaryReloadOpportunity. Os componentes que implementam a interface do coletor de eventos receberão a notificação de evento. O controle retornará depois que todos os componentes forem notificados.

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

Essa API foi introduzida no Visual Studio 12 Atualização 2 (DkmApiVersion.VS12Update2).

(Herdado de DkmModuleInstance)
OnModuleModified()

Esse método é chamado quando um módulo é alterado devido ao EnC ou ao código emitido dinamicamente.

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

Essa API foi introduzida no Visual Studio 14 RTM (DkmApiVersion.VS14RTM).

(Herdado de DkmModuleInstance)
OnSymbolsLoaded(DkmModule, Boolean)

Esse método é invocado por monitores de depuração base em resposta a uma chamada para IDkmModuleSymbolsLoaded.RaiseSymbolsLoadedEvent. Esse método deve ser invocado do thread de evento ou do thread de solicitação como parte de um recarregamento. Os monitores de depuração base devem alternar de forma síncrona para o thread de evento, pausar o processo de destino e invocar OnSymbolsLoaded.

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

(Herdado de DkmModuleInstance)
OnSymbolsUpdated(DkmModule)

Gerar um evento ModuleSymbolsUpdated. Os componentes que implementam a interface do coletor de eventos receberão a notificação de evento. O controle retornará depois que todos os componentes forem notificados.

(Herdado de DkmModuleInstance)
ReadSymbols()

Esse método é invocado por manipuladores de símbolos para ler símbolos para DkmModuleInstances cujos símbolos residem na memória do depurador.

(Herdado de DkmModuleInstance)
RemoveDataItem<T>()

Remova a instância de 'T' desse contêiner. Geralmente, é desnecessário chamar esse método, pois um contêiner de dados será esvaziado automaticamente quando o objeto for fechado.

(Herdado de DkmDataContainer)
ResolveTypeName(String, ReadOnlyCollection<DkmClrType>)

Resolve um nome de tipo em um tipo. Se o tipo for genérico, os parâmetros genéricos não serão instanciados.

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

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

SetDataItem<T>(DkmDataCreationDisposition, T)

Coloque um novo item no contêiner de dados.

(Herdado de DkmDataContainer)
SetDisabled(Boolean)

Atualizações a status desabilitada em um módulo. Esse método só pode ser chamado de um evento ModuleInstanceLoad. Ao desabilitar um módulo, é comum também suprimir o evento de carregamento do módulo.

(Herdado de DkmModuleInstance)
SetModule(DkmModule, Boolean)

Esse método é invocado por um provedor de símbolos para associar um DkmModule a um DkmModuleInstance e disparar um evento ModuleSymbolsLoaded. Ele pode ser chamado apenas uma vez para um objeto DkmModuleInstance. Chamar essa API estabelecerá a associação DkmModule-DkmModuleInstance<>, bem como fará com que um evento ModuleSymbolsLoaded seja acionado.

(Herdado de DkmModuleInstance)
TryLoadBinary()

Tentativa de carregar um binário que falhou anteriormente ao carregar usando caminhos de símbolo atualizados.

(Herdado de DkmModuleInstance)
TryLoadBinary(DkmWorkList, DkmCompletionRoutine<DkmTryLoadBinaryAsyncResult>)

Tentativa de carregar um binário que falhou anteriormente ao carregar usando caminhos de símbolo atualizados.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

(Herdado de DkmModuleInstance)
TryLoadDecompiledSymbols()

Tenta carregar símbolos descompilados armazenados em cache para o módulo.

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

Essa API foi introduzida no Visual Studio 17 Atualização 5 (DkmApiVersion.VS17Update5).

TryLoadDecompiledSymbols(DkmWorkList, DkmCompletionRoutine<DkmTryLoadDecompiledSymbolsAsyncResult>)

Tenta carregar símbolos descompilados armazenados em cache para o módulo.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 17 Atualização 5 (DkmApiVersion.VS17Update5).

TryLoadSymbols()

Chamado para iniciar o carregamento de símbolos para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

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

(Herdado de DkmModuleInstance)
TryLoadSymbols(DkmSymbolLoadFlags)

Chamado para iniciar o carregamento de símbolos para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

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

Essa API foi introduzida no Visual Studio 17 Atualização 4 (DkmApiVersion.VS17Update4).

(Herdado de DkmModuleInstance)
TryLoadSymbols(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)

Chamado para iniciar o carregamento de símbolos para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

(Herdado de DkmModuleInstance)
TryLoadSymbols(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsAsyncResult>)

Chamado para iniciar o carregamento de símbolos para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

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

Essa API foi introduzida no Visual Studio 17 Atualização 4 (DkmApiVersion.VS17Update4).

(Herdado de DkmModuleInstance)
TryLoadSymbolsCallback()

Chamado para iniciar o carregamento de símbolos para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

Restrição de local: isso pode ser chamado do cliente ou do servidor. A implementação do servidor desse é um cache para evitar chamadas de rede desnecessárias. O cliente vai diretamente para a implementação "real", o que também garante que os reattempts retornem antecipadamente.

Essa API foi introduzida no Visual Studio 17 RTM (DkmApiVersion.VS17RTM).

(Herdado de DkmModuleInstance)
TryLoadSymbolsCallback(DkmWorkList, DkmCompletionRoutine<DkmTryLoadSymbolsCallbackAsyncResult>)

Chamado para iniciar o carregamento de símbolos para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: isso pode ser chamado do cliente ou do servidor. A implementação do servidor desse é um cache para evitar chamadas de rede desnecessárias. O cliente vai diretamente para a implementação "real", o que também garante que os reattempts retornem antecipadamente.

Essa API foi introduzida no Visual Studio 17 RTM (DkmApiVersion.VS17RTM).

(Herdado de DkmModuleInstance)
TryLoadSymbolsCallback177(DkmSymbolLoadFlags)

Chamado para iniciar o carregamento de símbolos presentes localmente para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

Restrição de local: isso pode ser chamado do cliente ou do servidor. A implementação do servidor desse é um cache para evitar chamadas de rede desnecessárias. O cliente vai diretamente para a implementação "real", o que também garante que os reattempts retornem antecipadamente.

Essa API foi introduzida no Visual Studio 17 Atualização 7 (DkmApiVersion.VS17Update7).

(Herdado de DkmModuleInstance)
TryLoadSymbolsCallback177(DkmWorkList, DkmSymbolLoadFlags, DkmCompletionRoutine<DkmTryLoadSymbolsCallback177AsyncResult>)

Chamado para iniciar o carregamento de símbolos presentes localmente para DkmModuleInstances cujos símbolos não foram encontrados quando o módulo foi carregado.

Esse método acrescentará um novo item de trabalho à lista de trabalho especificada e retornará depois que o item de trabalho for acrescentado. O processamento real do item de trabalho é assíncrono. O chamador será notificado de que a solicitação foi concluída por meio da rotina de conclusão.

Restrição de local: isso pode ser chamado do cliente ou do servidor. A implementação do servidor desse é um cache para evitar chamadas de rede desnecessárias. O cliente vai diretamente para a implementação "real", o que também garante que os reattempts retornem antecipadamente.

Essa API foi introduzida no Visual Studio 17 Atualização 7 (DkmApiVersion.VS17Update7).

(Herdado de DkmModuleInstance)
TryResolveToken(DkmStackWalkFrame, Int32, DkmClrType, Int32)

Tenta resolve um token de dentro do escopo deste módulo para o módulo de definição.

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

Essa API foi introduzida no Visual Studio 17 Atualização 8 (DkmApiVersion.VS17Update8).

Unload()

Marque o objeto Unload como descarregado e notifique os componentes que implementam a interface do coletor de eventos. O controle retornará depois que todos os componentes forem notificados.

Esse método só pode ser chamado pelo componente que criou o objeto .

(Herdado de DkmModuleInstance)

Aplica-se a