Teilen über

ICLRTask::SwitchIn-Methode

Benachrichtigt die Common Language Runtime (CLR), dass sich die Aufgabe, die die aktuelle ICLRTask-instance darstellt, jetzt in einem betriebsfähigen Zustand befindet.

Syntax

HRESULT SwitchIn (  
    [in] HANDLE threadHandle  
);

Parameter

threadHandle
[in] Ein Handle für den physischen Thread, in dem die durch die aktuelle ICLRTask-Instanz dargestellte Aufgabe ausgeführt wird.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK SwitchIn wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE Die 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.
HOST_E_INVALIDOPERATION SwitchIn wurde ohne einen vorherigen Aufruf der SwitchOut-Methode aufgerufen.

Bemerkungen

Der Parameter threadHandle stellt ein Handle für den Betriebssystemthread dar, für den die durch die aktuelle ICLRTask-Instanz dargestellte Aufgabe geplant wurde. Wenn in diesem Thread ein Identitätswechsel aufgetreten ist, müssen Sie IHostSecurityManager::RevertToSelf aufrufen, bevor Sie die Aufgabe einwechseln.

Hinweis

Ein Aufruf von SwitchIn ohne einen vorangegangenen Aufruf von SwitchOut schlägt mit dem HRESULT-Wert „HOST_E_INVALIDOPERATION“ fehl.

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.

Siehe auch

  • Last updated on