Methode IHostSecurityManager::OpenThreadToken

Artikel
05/10/2023

Hiermee opent u het discretionaire toegangstoken dat is gekoppeld aan de thread die momenteel wordt uitgevoerd.

Syntaxis

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

Parameters

dwDesiredAccess
[in] Een masker van toegangswaarden waarmee de aangevraagde typen toegang tot het threadtoken worden opgegeven. Deze waarden worden gedefinieerd in de functie Win32 OpenThreadToken . De aangevraagde toegangstypen worden afgestemd op de discretionaire toegangsbeheerlijst (DACL) van het token om te bepalen welke typen toegang moeten worden verleend of geweigerd.

bOpenAsSelf
[in] true opgeven dat de toegangscontrole moet worden uitgevoerd met behulp van de beveiligingscontext van het proces voor de aanroepende thread; false om op te geven dat de toegangscontrole moet worden uitgevoerd met behulp van de beveiligingscontext voor de aanroepende thread zelf. Als de thread een client imiteert, kan de beveiligingscontext die van een clientproces zijn.

phThreadToken
[uit] Een aanwijzer naar het zojuist geopende toegangstoken.

Retourwaarde

HRESULT	Beschrijving
S_OK	`OpenThreadToken` is geretourneerd.
HOST_E_CLRNOTAVAILABLE	De COMMON Language Runtime (CLR) is niet geladen in een proces of de CLR heeft een status waarin beheerde code niet kan worden uitgevoerd of de aanroep kan worden verwerkt.
HOST_E_TIMEOUT	Er is een time-out opgetreden voor het gesprek.
HOST_E_NOT_OWNER	De beller is niet de eigenaar van het slot.
HOST_E_ABANDONED	Een gebeurtenis is geannuleerd terwijl er een geblokkeerde thread of glasvezel op wachtte.
E_FAIL	Er is een onbekende catastrofale fout opgetreden. Wanneer een methode E_FAIL retourneert, is de CLR niet meer bruikbaar binnen het proces. Volgende aanroepen naar hostingmethoden retourneren HOST_E_CLRNOTAVAILABLE.

Opmerkingen

IHostSecurityManager::OpenThreadToken gedraagt zich op dezelfde manier als de bijbehorende Win32-functie met dezelfde naam, behalve dat de Win32-functie de aanroeper toestaat een ingang door te geven aan een willekeurige thread, terwijl IHostSecurityManager::OpenThreadToken alleen het token wordt geopend dat is gekoppeld aan de aanroepende thread.

Het HANDLE type is niet COM-compatibel, dat wil gezegd, de grootte is specifiek voor het besturingssysteem en vereist aangepaste marshalling. Dit token is dus alleen bedoeld voor gebruik binnen het proces, tussen de CLR en de host.

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: Opgenomen als een resource in MSCorEE.dll

.NET Framework versies: beschikbaar sinds 2.0

Delen via