ICorDebugManagedCallback2::Exception-Methode

Artikel
08/10/2011

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

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 ICorDebugAppDomain-Objekt, das die Anwendungsdomäne mit dem Thread darstellt, 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 vom dwEventType-Parameter bestimmt. Weitere Informationen finden Sie in der Tabelle im Abschnitt "Hinweise".
nOffset
[in] Eine ganze Zahl, die einen Offset angibt, wie vom dwEventType-Parameter bestimmt. Weitere Informationen finden Sie in der Tabelle im Abschnitt "Hinweise".
dwEventType
[in] Ein Wert der CorDebugExceptionCallbackType-Enumeration, der den Typ dieses Ausnahmerückrufs angibt.
dwFlags
[in] Ein Wert der CorDebugExceptionFlags-Enumeration, der zusätzliche Informationen über die Ausnahme angibt.

Hinweise

Der Exception-Rückruf wird während der Suchphase des Ausnahmebehandlungsprozesses an verschiedenen Punkten aufgerufen. Das bedeutet, dass er beim Entladen einer Ausnahme mehrmals aufgerufen werden kann.

Die Ausnahme, die verarbeitet wird, kann vom ICorDebugThread-Objekt abgerufen werden, auf das vom pThread-Parameter verwiesen wird.

Der jeweilige Frame und Offset werden folgendermaßen durch den dwEventType-Parameter 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 liegt.	Der Anweisungszeiger im Frame.
DEBUG_EXCEPTION_CATCH_HANDLER_FOUND	Der Frame, der den catch-Handler enthält.	Der Microsoft Intermediate Language (MSIL)-Offset am Anfang des catch-Handlers.
DEBUG_EXCEPTION_UNHANDLED	NULL	Nicht definiert.