ICLRPolicyManager::SetActionOnFailure metódus

Meghatározza azt a szabályzatműveletet, amely a közös nyelvi futtatókörnyezetet (CLR) a megadott hiba bekövetkezésekor hajtja végre.

Szintaxis

HRESULT SetActionOnFailure (  
    [in] EClrFailure   failure,  
    [in] EPolicyAction action  
);

Paraméterek

failure
[in] Az egyik EClrFailure érték, amely azt jelzi, hogy milyen típusú hiba esetén kell elvégezni a műveletet.

action
[in] Az EPolicyAction egyik értéke, amely a hiba bekövetkezésekor végrehajtandó műveletet jelzi. A támogatott értékek listáját a Megjegyzések szakaszban találja.

Visszatérési érték

HRESULT Description
S_OK SetActionOnFailure sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem tudja futtatni a felügyelt kódot, vagy nem tudja sikeresen feldolgozni a hívást.
HOST_E_TIMEOUT A hívás túllépte az időkorlátot.
HOST_E_NOT_OWNER A hívó nem rendelkezik a zárral.
HOST_E_ABANDONED Egy esemény megszakadt, miközben egy blokkolt szál vagy szál várakozott rá.
E_FAIL Ismeretlen katasztrofális hiba történt. Miután egy metódus visszaadta E_FAIL, a CLR már nem használható a folyamaton belül. Az üzemeltetési módszerekre irányuló későbbi hívások HOST_E_CLRNOTAVAILABLE adnak vissza.
E_INVALIDARG A megadott művelethez nem állítható be szabályzatművelet, vagy érvénytelen szabályzatművelet lett megadva a művelethez.

Megjegyzések

Alapértelmezés szerint a CLR kivételt jelez, ha nem sikerül lefoglalni egy erőforrást, például a memóriát. SetActionOnFailure lehetővé teszi, hogy a gazdagép felülbírálja ezt a viselkedést a hiba esetén végrehajtandó szabályzatművelet megadásával. Az alábbi táblázat az EClrFailure (oszlopok) és az EPolicyAction (sorok) támogatott értékeinek kombinációit mutatja be.

FAIL_NonCriticalResource FAIL_CriticalResource FAIL_FatalRuntime FAIL_OrphanedLock FAIL_StackOverflow FAIL_AccessViolation FAIL_CodeContract
eNoAction X X N/A
eThrowException X X N/A
eAbortThread X X N/A X
eRudeAbortThread X X N/A X
eUnloadAppDomain X X X N/A X
eRudeUnloadAppDomain X X X X N/A X
eExitProcess X X X X N/A X
eFastExitProcess X X X X N/A
eRudeExitProcess X X X X X N/A
eDisableRuntime X X X X X N/A

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: MSCorEE.h

Könyvtár: Erőforrásként szerepel a MSCorEE.dll

.NET-keretrendszer verziók: 2.0 óta érhető el

Lásd még

  • Last updated on