IHostSecurityManager::SetThreadToken-Methode
Legt ein Handle für den aktuell ausgeführten Thread fest.
HRESULT SetThreadToken (
[in] HANDLE hToken
);
Parameter
- hToken
[in] Ein Handle für das Token, das für den aktuell ausgeführten Thread festegelegt werden soll.
Rückgabewert
HRESULT |
Beschreibungen |
|---|---|
S_OK |
SetThreadToken erfolgreich zurückgegeben. |
HOST_E_CLRNOTAVAILABLE |
Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann. |
HOST_E_TIMEOUT |
Der Aufruf hat das Zeitlimit überschritten. |
HOST_E_NOT_OWNER |
Der Aufrufer ist nicht Besitzer der Sperre. |
HOST_E_ABANDONED |
Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat. |
E_FAIL |
Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
Hinweise
IHostSecurityManager::SetThreadToken verhält sich ähnlich wie die entsprechende Win32-Funktion desselben Namens, allerdings mit der Ausnahme, dass die Win32-Funktion es dem Aufrufer ermöglicht, 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 spezifisch für ein Betriebssystem, und er erfordert benutzerdefiniertes Marshallen. Dieses Token kann daher nur innerhalb des Prozesses zwischen der CLR und dem Host verwendet werden.
Anforderungen
Plattformen: siehe Systemanforderungen für .NET Framework.
Header: MSCorEE.h
Bibliothek: als Ressource in MSCorEE.dll enthalten
.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0