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.