ICLRPolicyManager::SetDefaultAction-Methode

Artikel
08/10/2011

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

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

Parameter

operation
[in] Einer der EClrOperation-Werte, der die Aktion angibt, für die das Verhalten der CLR angepasst werden sollte.
action
[in] Einer der EPolicyAction-Werte, der die Richtlinienaktion angibt, die die CLR durchführen soll, wenn operation stattfindet.

Rückgabewert

HRESULT	Beschreibungen
S_OK	SetDefaultAction 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.
E_INVALIDARG	Es wurde eine ungültige action für die operation angegeben, oder es wurde ein ungültiger Wert für operation bereitgestellt.

Hinweise

Nicht alle Richtlinienaktionswerte können für CLR-Vorgänge als Standardverhalten angegeben werden. SetDefaultAction kann in der Regel nur zur Eskalation von Verhalten verwendet werden. Ein Host kann z. B. angeben, dass Threadabbrüche in abrupte Threadabbrüche umgewandelt werden. Das Gegenteil kann jedoch nicht angegeben werden. Die Tabelle unten beschreibt die gültigen action-Werte für jeden möglichen operation-Wert.

Der 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