ICLRPolicyManager::SetActionOnFailure — Metoda
Określa akcję zasad, które środowisko uruchomieniowe języka wspólnego (CLR) powinno podjąć w przypadku wystąpienia określonego błędu.
Składnia
HRESULT SetActionOnFailure (
[in] EClrFailure failure,
[in] EPolicyAction action
);
Parametry
failure
[in] Jedna z wartości EClrFailure wskazująca typ błędu, dla którego należy podjąć akcję.
action
[in] Jedna z wartości EPolicyAction wskazująca akcję do wykonania w przypadku wystąpienia błędu. Aby uzyskać listę obsługiwanych wartości, zobacz sekcję Uwagi.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | SetActionOnFailure zwrócone pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić zarządzanego kodu lub przetworzyć wywołania pomyślnie. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwróci E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
| E_INVALIDARG | Nie można ustawić akcji zasad dla określonej operacji lub określono nieprawidłową akcję zasad dla operacji. |
Uwagi
Domyślnie clR zgłasza wyjątek, gdy nie można przydzielić zasobu, takiego jak pamięć. SetActionOnFailure umożliwia hostowi zastąpienie tego zachowania przez określenie akcji zasad do wykonania po niepowodzeniu. W poniższej tabeli przedstawiono kombinacje obsługiwanych wartości EClrFailure (kolumn) i EPolicyAction (wierszy).
FAIL_NonCriticalResource |
FAIL_CriticalResource |
FAIL_FatalRuntime |
FAIL_OrphanedLock |
FAIL_StackOverflow |
FAIL_AccessViolation |
FAIL_CodeContract |
|
|---|---|---|---|---|---|---|---|
eNoAction |
X | X | Nie dotyczy | ||||
eThrowException |
X | X | Nie dotyczy | ||||
eAbortThread |
X | X | Nie dotyczy | X | |||
eRudeAbortThread |
X | X | Nie dotyczy | X | |||
eUnloadAppDomain |
X | X | X | Nie dotyczy | X | ||
eRudeUnloadAppDomain |
X | X | X | X | Nie dotyczy | X | |
eExitProcess |
X | X | X | X | Nie dotyczy | X | |
eFastExitProcess |
X | X | X | X | Nie dotyczy | ||
eRudeExitProcess |
X | X | X | X | X | Nie dotyczy | |
eDisableRuntime |
X | X | X | X | X | Nie dotyczy |
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
wersje .NET Framework: dostępne od wersji 2.0
