IHostSecurityManager::SetSecurityContext metódus

Beállítja az aktuálisan végrehajtó szál biztonsági környezetét.

Szemantika

HRESULT SetSecurityContext (
    [in]  EContextType eContextType,
    [out] IHostSecurityContext** ppSecurityContext
);

Paraméterek

eContextType [in] Az egyik EContextType érték, amely azt jelzi, hogy a közös nyelvi futtatókörnyezet (CLR) milyen típusú környezetet helyez el a gazdagépen.

ppSecurityContext [kifelé] Egy új IHostSecurityContext objektum címére mutató mutató.

Visszaadott érték

HRESULT Leírás
S_OK SetSecurityContext sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A CLR nincs betöltve egy folyamatba, vagy a CLR olyan állapotban van, amelyben nem futtathat 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árt rá.
E_FAIL Ismeretlen katasztrofális hiba történt. Amikor egy metódus E_FAIL ad vissza, a CLR már nem használható a folyamaton belül. A metódusok későbbi hívásai HOST_E_CLRNOTAVAILABLE térnek vissza.

Megjegyzések

A CLR több forgatókönyvben is hív SetSecurityContext . Mielőtt végrehajtja az osztály- és modulkonstruktorokat és -véglegesítőket, a CLR felhívja SetSecurityContext a gazdagépet a végrehajtási hibák elleni védelemre. Ezután visszaállítja a biztonsági környezetet az eredeti állapotára a konstruktor vagy a véglegesítő végrehajtása után egy másik hívással SetSecurityContext. Hasonló minta történik az I/O-befejezéssel. Ha a gazdagép implementálja az IHostIoCompletionManagert, a CLR a gazdagép ICLRIoCompletionManager::OnComplete hívását követően hívja SetSecurityContext meg.

A feldolgozószálak aszinkron pontjain a CLR az IHostThreadPoolManager::QueueUserWorkItem rendszeren belül vagy azon belül ThreadPool.QueueUserWorkItem hívja meg a hívásokat SetSecurityContext attól függően, hogy a gazdagép vagy a CLR implementálja-e a szálkészletet.

Követelmények

Platformok: Lásd a rendszerkövetelményeket.

Fejléc: MSCorEE.h

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

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

Lásd még

  • Last updated on