ICLRPolicyManager::SetUnhandledExceptionPolicy-Methode

Artikel
08/10/2011

Gibt das Verhalten der Common Language Runtime (CLR) an, wenn eine nicht behandelte Ausnahme auftritt.

HRESULT SetUnhandledExceptionPolicy (
    [in] EClrUnhandledExceptionPolicy policy
);

Parameter

policy
[in] Einer der EClrUnhandledException-Werte, die angeben, ob das Verhalten von der CLR oder vom Host festgelegt wird.

Rückgabewert

HRESULT	Beschreibungen
S_OK	SetUnhandledExceptionPolicy erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die CLR wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Nachdem eine Methode E_FAIL zurückgegeben hat, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

Standardmäßig ist die CLR der abschließende Handler für alle nicht behandelten Ausnahmen. Das Standardverhalten ist der Abbruch des Prozesses. Der Host kann dieses Verhalten ändern, indem er den policy-Wert auf eHostDeterminedPolicy festlegt. Mit diesem Wert kann der Host wie bei früheren Versionen der CLR sein eigenes Standardverhalten implementieren.