Megosztás:


IHostSecurityManager::OpenThreadToken metódus

Megnyitja az aktuálisan végrehajtó szálhoz társított diszkréciós hozzáférési jogkivonatot.

Szintaxis

HRESULT OpenThreadToken (  
    [in]  DWORD    dwDesiredAccess,
    [in]  BOOL     bOpenAsSelf,
    [out] HANDLE   *phThreadToken  
);  

Paraméterek

dwDesiredAccess
[in] Hozzáférési értékek maszkja, amely megadja a száltoken kért hozzáférési típusait. Ezek az értékek a Win32 OpenThreadToken függvényben vannak definiálva. A kért hozzáférési típusok egyeztetése a jogkivonat diszkréciós hozzáférés-vezérlési listájával (DACL) történik annak meghatározásához, hogy milyen típusú hozzáférést kell megadni vagy megtagadni.

bOpenAsSelf
[in] true annak meghatározása, hogy a hozzáférés-ellenőrzést a híváslánc folyamatának biztonsági környezetével kell elvégezni; false annak megadásához, hogy a hozzáférés-ellenőrzést magának a hívásláncnak a biztonsági környezetével kell elvégezni. Ha a szál megszemélyesít egy ügyfelet, a biztonsági környezet lehet egy ügyfélfolyamat.

phThreadToken
[kifelé] Mutató az újonnan megnyitott hozzáférési jogkivonatra.

Visszatérési érték

HRESULT Description
S_OK OpenThreadToken sikeresen visszaadott.
HOST_E_CLRNOTAVAILABLE A közös nyelvi futtatókörnyezet (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

IHostSecurityManager::OpenThreadToken hasonlóan viselkedik, mint az azonos nevű Win32-függvény, azzal a kivétellel, hogy a Win32 függvény lehetővé teszi, hogy a hívó egy leírót adjon át egy tetszőleges szálnak, miközben IHostSecurityManager::OpenThreadToken csak a híváslánchoz társított jogkivonatot nyitja meg.

A HANDLE típus nem COM-kompatibilis, azaz mérete az operációs rendszerre jellemző, és egyéni rendezést igényel. Így ez a jogkivonat csak a folyamaton belül használható, a CLR és a gazdagép között.

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ő

Lásd még