Delen via

MDAInfo-structuur

  • Artikel

Bevat details over de Event_MDAFired gebeurtenis, waardoor het maken van een Managed DeBugging Assistant (MDA) wordt geactiveerd.

Syntax

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

Leden

Lid Beschrijving
lpMDACaption De titel van de huidige MDA. De titel beschrijft het soort fout dat de Event_MDAFired gebeurtenis heeft geactiveerd.
lpMDAMessage Het uitvoerbericht van de huidige MDA.

Opmerkingen

Beheerde foutopsporingsassistenten (MDA's) zijn hulpmiddelen voor foutopsporing die in combinatie met de Common Language Runtime (CLR) werken om taken uit te voeren, zoals het identificeren van ongeldige voorwaarden in de runtime-uitvoeringsengine of het dumpen van aanvullende informatie over de status van de engine. MDA's genereren XML-berichten over gebeurtenissen die anders moeilijk te vangen zijn. Ze zijn met name handig voor foutopsporing van overgangen tussen beheerde en onbeheerde code.

De runtime voert de volgende stappen uit wanneer een gebeurtenis die het maken van een MDA activeert, wordt geactiveerd:

  • Als de host geen IActionOnCLREvent-exemplaar heeft geregistreerd door ICLROnEventManager::RegisterActionOnEvent aan te roepen om op de hoogte te worden gesteld van een Event_MDAFired gebeurtenis, gaat de runtime verder met het standaardgedrag, niet-gehost.

  • Als de host een handler voor deze gebeurtenis heeft geregistreerd, controleert de runtime of er een foutopsporingsprogramma aan het proces is gekoppeld. Als dat zo is, wordt de runtime ingebroken in het foutopsporingsprogramma. Wanneer het foutopsporingsprogramma wordt voortgezet, wordt de host aangeroepen. Als er geen foutopsporingsprogramma is gekoppeld, roept IActionOnCLREvent::OnEvent de runtime aan en geeft een aanwijzer door aan een MDAInfo exemplaar als parameter data .

De host kan ervoor kiezen om MDA's te activeren en een melding te ontvangen wanneer een MDA wordt geactiveerd. Dit biedt de host de mogelijkheid om het standaardgedrag te overschrijven en de beheerde thread af te breken die de gebeurtenis heeft gegenereerd, om te voorkomen dat de processtatus wordt beschadigd. Zie Diagnosefouten met beheerde foutopsporingsassistenten voor meer informatie over het gebruik van MDA's.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.idl

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Zie ook