Compartilhar via


Estrutura de MDAInfo

Fornece detalhes sobre o Event_MDAFired o evento, que dispara a criação de um Assistente de depuração gerenciada (MDA).

typedef struct _MDAInfo {
    LPCWSTR  lpMDACaption;
    LPCWSTR  lpMDAMessage
} MDAInfo;

Membros

Membro

Descrição

lpMDACaption

O título do MDA atual. O título descreve o tipo de falha que disparou o Event_MDAFired de evento.

lpMDAMessage

A mensagem de saída fornecida pelo MDA atual.

Comentários

Assistentes de depuração gerenciada (MDAs) são depuração que funcionam em conjunto com o common language runtime (CLR) para executar tarefas como, por exemplo, identificando condições inválidas no mecanismo de execução em tempo de execução ou despejar informações adicionais sobre o estado do mecanismo. MDAs geram mensagens XML sobre eventos que são difíceis de trapping. Eles são especialmente úteis para transições entre código gerenciado e de depuração.

O tempo de execução realiza as seguintes etapas, quando um evento que dispara a criação de um MDA é acionado:

  • Se o host não registrou um IActionOnCLREvent instância chamando ICLROnEventManager::RegisterActionOnEvent para ser notificado de uma Event_MDAFired o tempo de execução de evento, prossegue com o seu padrão, não hospedado comportamento.

  • Se o host registrou um manipulador para este evento, o runtime verifica se um depurador é anexado ao processo. Se for, o runtime entra no depurador. Quando o depurador continua, ele chama o host. Se nenhum depurador anexado, o tempo de execução chama IActionOnCLREvent::OnEvent e passa um ponteiro para um MDAInfo instância como o data parâmetro.

O host pode escolher ativar MDAs e ser notificado quando um MDA é ativado. Isso o host de uma oportunidade para substituir o comportamento padrão e para anular o thread gerenciado que disparou o evento, para impedir a corromper o estado do processo. Para obter mais informações sobre como usar os MDAs, consulte Diagnosticar erros com assistentes de depuração gerenciada.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: MSCorEE.idl

Biblioteca: Incluído como um recurso em mscoree

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Consulte também

Conceitos

Diagnosticar erros com assistentes de depuração gerenciada

Outros recursos

Estruturas de hospedagem.