Methode ICLRErrorReportingManager::BeginCustomDump

Artikel
04/08/2023

Hiermee geeft u de configuratie van aangepaste heapdumps voor foutrapportage.

Syntaxis

HRESULT BeginCustomDump (  
    [in] ECustomDumpFlavor dwFlavor,  
    [in] DWORD dwNumItems,  
    [in, size_is(dwNumItems), length_is(dwNumItems)] CustomDumpItem items[],  
    DWORD dwReserved  
);

Parameters

dwFlavor
[in] Een ECustomDumpFlavor-waarde die het type heapdump aangeeft waarop de aangepaste heapdump moet worden gebouwd.

dwNumItems
[in] De lengte van de items matrix. Als dwFlavor niet DUMP_FLAVOR_Mini is, dwNumItems moet nul zijn.

items
[in] Een matrix van CustomDumpItem-exemplaren , waarin de items worden opgegeven die moeten worden toegevoegd aan de minidump. Als dwFlavor niet DUMP_FLAVOR_Mini is, items moet null zijn.

dwReserved
[in] Gereserveerd voor toekomstig gebruik.

Retourwaarde

HRESULT	Beschrijving
S_OK	De methode is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De Common Language Runtime (CLR) is niet geladen in een proces of de CLR bevindt zich in een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT	Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER	De beller is niet de eigenaar van het vergrendelingsslot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of vezel op wachtte.
E_FAIL	Er is een onbekende catastrofale fout opgetreden. Nadat een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.

Opmerkingen

Met de BeginCustomDump methode wordt een aangepaste heapdumpconfiguratie ingesteld. Met de methode EndCustomDump wordt de aangepaste heapdumpconfiguratie gewist en worden alle bijbehorende statussen vrijgemaakt. Deze moet worden aangeroepen nadat de aangepaste heapdump is voltooid.

Belangrijk

Het niet aanroepen EndCustomDump zorgt ervoor dat geheugen lekt.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Delen via