ICLRTaskManager::CreateTask-Methode

Artikel
08/10/2011

Fordert explizit an, dass die Common Language Runtime (CLR) eine neue Aufgabe erstellt.

HRESULT CreateTask (
    [out] ICLRTask **pTask
);

Parameter

pTask
[out] Ein Zeiger auf die Adresse einer neu erstellten ICLRTask oder NULL, wenn die Aufgabe nicht erstellt werden konnte.

Rückgabewert

HRESULT	Beschreibung
S_OK	Die Methode wurde erfolgreich zurückgegeben.
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.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher für die angeforderte Ressource verfügbar.

Hinweise

Die CLR erstellt bei der Initialisierung automatisch eine neue Aufgabe, wenn Benutzercode einen Thread erstellt, für den Typen im System.Threading-Namespace verwendet werden, oder wenn der Threadpool vergrößert wurde. Außerdem erstellt sie Aufgaben, wenn eine verwaltete Funktion durch nicht verwalteten Code aufgerufen wird.

CreateTask ermöglicht es dem Host, explizit das Erstellen einer neuen Aufgabe durch die CLR anzufordern. Der Host kann diese Methode z. B. aufrufen, um Datenstrukturen im Voraus zu initialisieren.