ICLRPolicyManager::SetActionOnTimeout-Methode

Artikel
06/12/2023

Gibt die Richtlinienaktion an, die die Common Language Runtime (CLR) ausführen soll, wenn für den angegebenen Vorgang ein Timeout auftritt.

Syntax

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

Parameter

operation
[in] Einer der EClrOperation-Werte, der den Vorgang angibt, für den die Timeoutaktion angegeben werden soll. Die folgenden Werte werden unterstützt:

OPR_AppDomainUnload
OPR_ProcessExit
OPR_ThreadRudeAbortInCriticalRegion
OPR_ThreadRudeAbortInNonCriticalRegion

action
[in] Einer der EPolicyAction-Werte, der die Richtlinienaktion angibt, die ausgeführt werden soll, wenn für den Vorgang ein Timeout auftritt.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	`SetActionOnTimeout` 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 den angegebenen Vorgang (`operation`) kann kein Timeout festgelegt werden, oder für `operation` wurde ein ungültiger Wert angegeben.

Bemerkungen

Der Timeoutwert kann entweder das von der CLR festgelegte Standardtimeout oder ein Wert sein, der vom Host in einem Aufruf der ICLRPolicyManager::SetTimeout-Methode angegeben wurde.

Nicht alle Richtlinienaktionswerte können als Timeoutverhalten für CLR-Vorgänge angegeben werden. SetActionOnTimeout wird in der Regel nur verwendet, um Verhalten zu eskalieren. Beispielsweise kann ein Host angeben, dass Threadabbrüche in nicht unterstützte Threadabbrüche umgewandelt werden sollen. Er kann jedoch nicht das Gegenteil angeben. In der folgenden Tabelle werden die gültigen action-Werte für gültige operation-Werte beschrieben.

Wert für `operation`	Gültige Werte für `action`
OPR_ThreadRudeAbortInNonCriticalRegion OPR_ThreadRudeAbortInCriticalRegion	- eRudeAbortThread - eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_AppDomainUnload	- eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_ProcessExit	- 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.

Freigeben über