ICLRErrorReportingManager::BeginCustomDump-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt die Konfiguration von benutzerdefinierten Heapdumps für Fehlerberichte an.

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 Heapdumps angibt, auf dem der benutzerdefinierte Heapdump basieren soll.
dwNumItems
[in] Die Länge des items-Arrays. Wenn dwFlavor nicht DUMP_FLAVOR_Mini ist, muss dwNumItems 0 (null) sein.
items
[in] Ein Array von CustomDumpItem-Instanzen, die die Elemente angeben, die zum Minidump hinzugefügt werden sollen. Wenn dwFlavor nicht DUMP_FLAVOR_Mini ist, muss items NULL sein.
dwReserved
[in] Reserviert für zukünftige Verwendung.

Rückgabewert

HRESULT	Beschreibung
S_OK	Die Methode kehrte erfolgreich zurück.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Nachdem eine Methode E_FAIL zurückgegeben hat, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Die BeginCustomDump-Methode legt die benutzerdefinierte Heapdumpkonfiguration fest. Die EndCustomDump-Methode löscht die benutzerdefinierte Heapdumpkonfiguration und gibt jeden zugeordneten Zustand frei. Sollte aufgerufen werden, nachdem der benutzerdefinierte Heapdump beendet wurde.