IHostTaskManager::SwitchToTask-Methode
Aktualisiert: November 2007
Benachrichtigt den Host, dass er die aktuelle Aufgabe beenden soll.
HRESULT SwitchToTask (
[in] DWORD option
);
Parameter
- option
[in] Einer der WAIT_OPTION-Enumerationswerte. Er gibt an, welche Aktion der Host ausführen soll, wenn der angeforderte Vorgang blockiert.
Rückgabewert
HRESULT |
Beschreibung |
|---|---|
S_OK |
SwitchToTask kehrte erfolgreich zurück. |
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
Der Host kann auf Wunsch oder bei Bedarf in eine andere Aufgabe umschalten.
Tipp
SwitchToTask gibt nicht an, in welche Aufgabe der Host umschalten soll. Darin wird nur die Aufgabe angegeben, aus der er umschalten soll.
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