Freigeben über

ICorDebugManagedCallback2::Exception-Methode

Benachrichtigt den Debugger, dass eine Suche nach einem Ausnahmehandler gestartet wurde.

Syntax

HRESULT Exception (
    [in] ICorDebugAppDomain   *pAppDomain,
    [in] ICorDebugThread      *pThread,
    [in] ICorDebugFrame       *pFrame,
    [in] ULONG32              nOffset,
    [in] CorDebugExceptionCallbackType dwEventType,
    [in] DWORD                dwFlags
);

Die Parameter

pAppDomain [in] Ein Zeiger auf ein ICorDebugAppDomain -Objekt, das die Anwendungsdomäne darstellt, die den Thread enthält, in dem die Ausnahme ausgelöst wurde.

pThread [in] Ein Zeiger auf ein ICorDebugThread -Objekt, das den Thread darstellt, in dem die Ausnahme ausgelöst wurde.

pFrame [in] Ein Zeiger auf ein ICorDebugFrame -Objekt, das einen Frame darstellt, wie durch den dwEventType Parameter bestimmt. Weitere Informationen finden Sie in der Tabelle im Abschnitt "Hinweise".

nOffset [in] Eine ganze Zahl, die einen Offset angibt, wie durch den dwEventType Parameter bestimmt. Weitere Informationen finden Sie in der Tabelle im Abschnitt "Hinweise".

dwEventType [in] Ein Wert der CorDebugExceptionCallbackType-Aufzählung, die den Typ dieses Ausnahmerückrufs angibt.

dwFlags [in] Ein Wert der CorDebugExceptionFlags-Aufzählung , die zusätzliche Informationen zur Ausnahme angibt.

Bemerkungen

Der Exception Rückruf wird während der Suchphase des Ausnahmebehandlungsprozesses an verschiedenen Stellen aufgerufen. Das heißt, es kann mehr als einmal aufgerufen werden, während eine Ausnahme entspannt wird.

Die verarbeitete Ausnahme kann aus dem ICorDebugThread-Objekt abgerufen werden, auf das vom pThread Parameter verwiesen wird.

Der jeweilige Frame und Offset werden durch den dwEventType Parameter wie folgt bestimmt:

Wert von dwEventType Wert von pFrame Wert von nOffset
DEBUG_EXCEPTION_FIRST_CHANCE Der Frame, der die Ausnahme ausgelöst hat. Der Anweisungszeiger im Frame.
DEBUG_EXCEPTION_USER_FIRST_CHANCE Der Benutzercodeframe, der dem Punkt der ausgelösten Ausnahme am nächsten kommt. Der Anweisungszeiger im Frame.
DEBUG_EXCEPTION_CATCH_HANDLER_FOUND Der Frame, der den Catch-Handler enthält. Der CIL-Offset (Common Intermediate Language) des Anfangs des Catch-Handlers.
DEBUG_EXCEPTION_UNHANDLED NULL Undefiniert.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 2.0

Siehe auch

  • Last updated on