ICLRPolicyManager::SetDefaultAction-Methode

  • Artikel

Gibt die Richtlinienaktion an, die die Common Language Runtime (CLR) ausführen soll, wenn der angegebene Vorgang ausgeführt wird

Syntax

HRESULT SetDefaultAction (  
    [in] EClrOperation operation,  
    [in] EPolicyAction action  
);

Parameter

operation
[in] Einer der EClrOperation-Werte, der die Aktion angibt, für die das CLR-Verhalten angepasst werden soll

action
[in] Einer der EPolicyAction-Werte, der die Richtlinienaktion angibt, die die CLR ausführen soll, wenn operation auftritt

Rückgabewert

HRESULT BESCHREIBUNG
S_OK SetDefaultAction wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT Timeout des Aufrufs.
HOST_E_NOT_OWNER Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode „E_FAIL“ zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_INVALIDARG Für operation wurde eine ungültige action angegeben, oder für operation wurde ein ungültiger Wert angegeben.

Bemerkungen

Nicht alle Richtlinienaktionswerte können als Standardverhalten für CLR-Vorgänge angegeben werden. SetDefaultAction kann in der Regel nur verwendet werden, um Verhalten zu eskalieren. Beispielsweise kann ein Host angeben, dass Threadabbrüche in nicht unterstützte Threadabbrüche umgewandelt werden, aber er kann nicht das Gegenteil angeben. In der folgenden Tabelle werden die gültigen action-Werte für jeden möglichen operation-Wert beschrieben.

Wert für operation Gültige Werte für action
OPR_ThreadAbort – eAbortThread
– eRudeAbortThread
– eUnloadAppDomain
– eRudeUnloadAppDomain
– eExitProcess
– eFastExitProcess
– eRudeExitProcess
– eDisableRuntime
OPR_ThreadRudeAbortInNonCriticalRegion

OPR_ThreadRudeAbortInCriticalRegion		 – eRudeAbortThread
– eUnloadAppDomain
– eRudeUnloadAppDomain
– eExitProcess
– eFastExitProcess
– eRudeExitProcess
– eDisableRuntime
OPR_AppDomainUnload – eUnloadAppDomain
– eRudeUnloadAppDomain
– eExitProcess
– eFastExitProcess
– eRudeExitProcess
– eDisableRuntime
OPR_AppDomainRudeUnload – eRudeUnloadAppDomain
– eExitProcess
– eFastExitProcess
– eRudeExitProcess
– eDisableRuntime
OPR_ProcessExit – eExitProcess
– eFastExitProcess
– eRudeExitProcess
– eDisableRuntime
OPR_FinalizerRun - eNoAction
– eAbortThread
– eRudeAbortThread
– eUnloadAppDomain
– eRudeUnloadAppDomain
– eExitProcess
– eFastExitProcess
– eRudeExitProcess
– eDisableRuntime

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

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

Siehe auch