IHostSecurityManager::SetThreadToken-Methode
Legt ein Handle für den aktuell ausgeführten Thread fest.
Syntax
HRESULT SetThreadToken (
[in] HANDLE hToken
);
Parameter
hToken
[in] Ein Handle für das Token, das für den aktuell ausgeführten Thread festgelegt werden soll.
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | SetThreadToken wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann. |
| HOST_E_TIMEOUT | Timeout des Aufrufs. |
| HOST_E_NOT_OWNER | Der Aufrufer besitzt die Sperre nicht. |
| HOST_E_ABANDONED | Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat. |
| E_FAIL | Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
Bemerkungen
IHostSecurityManager::SetThreadToken verhält sich ähnlich wie die gleichnamige Win32-Funktion, mit dem Unterschied, dass die Win32-Funktion dem Aufrufer erlaubt, ein Handle an einen beliebigen Thread zu übergeben, während IHostSecurityManager::SetThreadToken ein Token nur dem aktuell ausgeführten Thread zuordnen kann.
Der HANDLE-Typ ist nicht COM-kompatibel, d. h. seine Größe ist betriebssystemspezifisch und erfordert ein benutzerdefiniertes Marshalling. Dieses Token ist daher nur für die Verwendung innerhalb des Prozesses (zwischen der CLR und dem Host) vorgesehen.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.
.NET Framework-Versionen: Seit 2.0 verfügbar.
