ICLRPolicyManager::SetActionOnFailure-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

Gibt die Richtlinienaktion an, die die Common Language Runtime (CLR) ausführen soll, wenn der angegebene Fehler auftritt.

HRESULT SetActionOnFailure (
    [in] EClrFailure   failure,
    [in] EPolicyAction action
);

Parameter

failure
[in] Einer der EClrFailure-Werte, die den Typ des Fehlers angeben, für den eine Aktion erfolgen soll.
action
[in] Einer der EPolicyAction-Werte, die angeben, welche Aktion erfolgen soll, wenn ein Fehler auftritt. Der einzige unterstützte failure-Wert von FAIL_FatalRuntime ist eRudeExitProcess. Wenn ein schwerwiegender Fehler auftritt, wird CLR standardmäßig deaktiviert. Für einen failure-Wert von FAIL_CriticalResource oder FAIL_NonCriticalResource werden die folgenden Werte unterstützt:
- eNoAction
- eThrowException
- eAbortThread
- eRudeAbortThread
- eUnloadAppDomain
- eRudeUnloadAppDomain
- eExitProcess
- eRudeExitProcess
- eDisableRuntime

Rückgabewert

HRESULT	Beschreibung
S_OK	SetActionOnFailure kehrte erfolgreich zurück.
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.
E_INVALIDARG	Für den angegebenen Vorgang kann keine Richtlinienaktion festgelegt werden, oder für den Vorgang wurde eine ungültige Richtlinienaktion angegeben.

Hinweise

Standardmäßig löst die CLR eine Ausnahme aus, wenn sie eine Ressource wie Arbeitsspeicher nicht reservieren kann. SetActionOnFailure ermöglicht dem Host, dieses Verhalten zu überschreiben, indem eine Richtlinienaktion angegeben wird, die bei einem Fehler erfolgen soll.