Freigeben über

ICorDebugManagedCallback2::Exception-Methode

  • Artikel

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
);

Parameter

pAppDomain[in] Ein Zeiger auf ein ICorDebugAppDo Standard Objekt, das die Anwendung darstellt Standard der den Thread enthält, auf den 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.

Hinweise

Der Exception-Rückruf wird in der Suchphase des Ausnahmebehandlungsprozesses an verschiedenen Stellen aufgerufen. Das heißt, er kann während der Entladung einer Ausnahme mehrmals aufgerufen werden.

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

Der jeweilige Frame und der 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 Benutzercode-Frame, der dem Punkt der ausgelösten Ausnahme am nächsten ist. 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 Nicht definiert.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

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

Siehe auch