ICLRPolicyManager::SetActionOnFailure — Metoda

  • Artykuł

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

Zobacz też