Teilen über

ICLRDataTarget3::GetExceptionRecord-Methode

Wird durch die Common Language Runtime (CLR)- Datenzugriffsdienste aufgerufen, um den Ausnahmedatensatz abzurufen, der dem Zielprozess zugordnet ist. Bei einem Sicherungsziel entspräche das z. B. dem Ausnahmedatensatz, der über das ExceptionParam-Argument zur MiniDumpWriteDump-Funktion in der Windows-Debughilfebibliothek (DbgHelp) übergeben wird.

Syntax

HRESULT GetExceptionRecord(
    [in] ULONG32 bufferSize,
    [out] ULONG32* bufferUsed,
    [out, size_is(bufferSize] BYTE* buffer
);

Parameter

bufferSize [in] Die Größe des Eingabepuffers in Byte. Dies muss gleich einer sizeof(MINIDUMP_EXCEPTION) sein.

bufferUsed [out] Ein Zeiger auf einen ULONG32 Typ, der die Anzahl der Bytes empfängt, die tatsächlich in den Puffer geschrieben wurden.

buffer [out] Ein Zeiger auf einen Speicherpuffer, der eine Kopie des Ausnahmedatensatzes empfängt. Der Ausnahmedatensatz wird als MINIDUMP_EXCEPTION-Typ zurückgegeben.

Rückgabewert

Der Rückgabewert ist S_OK bei Erfolg oder ein Fehler-HRESULT-Code bei einem Fehler. Zu den HRESULT-Codes können u. a. folgende Codes gehören:

Rückgabecode Beschreibung
S_OK Methode war erfolgreich. Der Ausnahmedatensatz ist in den Ausgabepuffer kopiert worden.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Kein Ausnahmedatensatz ist dem Ziel zugeordnet.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) Die Eingabepuffergröße ist ungleich sizeof(MINIDUMP_EXCEPTION).

Bemerkungen

MINIDUMP_EXCEPTION ist eine Struktur, die in „dbghelp.h“ und in „imagehlp.h“ im Windows SDK definiert wird.

Diese Methode wird vom Writer der Debuganwendung implementiert.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: ClrData.idl, ClrData.h

Bibliothek: CorGuids.lib

.NET Framework Versionen: Seit dem Update von November 2013 auf 4.5.1 verfügbar

Siehe auch

  • Last updated on