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
