IHostSecurityManager::SetSecurityContext metódus
Beállítja az éppen futó szál biztonsági környezetét.
Szintaxis
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ó.
Visszatérési érték
| HRESULT | Description |
|---|---|
| S_OK | SetSecurityContext 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á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. Az üzemeltetési módszerek későbbi hívásai HOST_E_CLRNOTAVAILABLE ad vissza. |
Megjegyzések
A CLR több forgatókönyvben is meghívja a hívásokat SetSecurityContext . Mielőtt végrehajtja az osztály- és modulkonstruktorokat és -véglegesítőket, a CLR meghívja SetSecurityContext a gazdagépet a végrehajtási hibák elleni védelem érdekében. 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, a következő hívással SetSecurityContext: . Hasonló minta fordul elő az I/O-befejezéskor. Ha a gazdagép az IHostIoCompletionManagert implementálja, a CLR az ICLRIoCompletionManager::OnComplete hívása után hívja SetSecurityContext meg a CLR-t.
A munkaszálak aszinkron pontjain a CLR az IHostThreadPoolManager::QueueUserWorkItem területen belül vagy azon belül hívja SetSecurityContextThreadPool.QueueUserWorkItem meg a hívásokat 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: 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 elérhető
