Freigeben über


ICLRTask::SwitchIn-Methode

Aktualisiert: November 2007

Benachrichtigt die Common Language Runtime (CLR), dass die von der aktuellen ICLRTask-Instanz dargestellte Aufgabe jetzt funktionsfähig ist.

HRESULT SwitchIn (
    [in] HANDLE threadHandle
);

Parameter

  • threadHandle
    [in] Ein Handle für den physischen Thread, auf dem die von der aktuellen ICLRTask-Instanz dargestellte Aufgabe ausgeführt wird.

Rückgabewert

HRESULT

Beschreibung

S_OK

SwitchIn kehrte erfolgreich zurück.

HOST_E_CLRNOTAVAILABLE

Die 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.

HOST_E_INVALIDOPERATION

SwitchIn wurde ohne einen vorhergehenden Aufruf von ICLRTask::SwitchOut-Methode aufgerufen.

Hinweise

Der threadHandle-Parameter stellt ein Handle für den Betriebssystemthread dar, auf dem die von der aktuellen ICLRTask-Instanz dargestellte Aufgabe geplant wurde. Wenn auf diesem Thread ein Identitätswechsel aufgetreten ist, müssen Sie vor dem Umschalten in die Aufgabe IHostSecurityManager::RevertToSelf aufrufen.

Tipp

Ein Aufruf von SwitchIn ohne einen vorausgehenden Aufruf von SwitchOut führt zum HRESULT-Fehlerwert HOST_E_INVALIDOPERATION.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.idl

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Referenz

ICLRTask-Schnittstelle

ICLRTaskManager-Schnittstelle

IHostTask-Schnittstelle

IHostTaskManager-Schnittstelle