Freigeben über

ICLRErrorReportingManager::BeginCustomDump-Methode

  • Artikel

Gibt die Konfiguration von benutzerdefinierten Heapabbildern für die Fehlerberichterstattung an.

Syntax

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

Parameter

dwFlavor
[in] Ein ECustomDumpFlavor-Wert , der die Art des Heapabbilds angibt, auf dem das benutzerdefinierte Heapabbild erstellt werden soll.

dwNumItems
[in] Die Länge des items Arrays. Wenn dwFlavor nicht DUMP_FLAVOR_Mini ist, dwNumItems sollte null sein.

items
[in] Ein Array von CustomDumpItem-Instanzen , das die Elemente angibt, die dem Minidump hinzugefügt werden sollen. Wenn dwFlavor nicht DUMP_FLAVOR_Mini ist, items sollte null sein.

dwReserved
[in] Reserviert für zukünftige Verwendung.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK Die Methode wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT Timeout des Aufrufs.
HOST_E_NOT_OWNER Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode „E_FAIL“ zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Die BeginCustomDump -Methode legt die konfiguration des benutzerdefinierten Heapabbilds fest. Die EndCustomDump-Methode löscht die konfiguration des benutzerdefinierten Heapabbilds und gibt jeden zugeordneten Zustand frei. Es sollte aufgerufen werden, nachdem das benutzerdefinierte Heapabbild abgeschlossen ist.

Wichtig

Ein Fehler beim Aufrufen EndCustomDump führt zu einem Speicherverlust.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch