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.
