ICLRTaskManager::CreateTask — Metoda
Żąda jawnie, że środowisko uruchomieniowe języka wspólnego (CLR) utworzy nowe zadanie.
Składnia
HRESULT CreateTask (
[out] ICLRTask **pTask
);
Parametry
pTask
[out] Wskaźnik do adresu nowo utworzonego obiektu ICLRTask lub null, jeśli nie można utworzyć zadania.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | Metoda została zwrócona pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania. |
| HOST_E_TIMEOUT | Upłynął limit czasu wywołania. |
| HOST_E_NOT_OWNER | Obiekt wywołujący nie jest właścicielem blokady. |
| HOST_E_ABANDONED | Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie. |
| E_FAIL | Wystąpił nieznany katastrofalny błąd. Gdy metoda zwraca E_FAIL, clR nie będzie już można używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Za mało pamięci jest dostępna do przydzielenia żądanego zasobu. |
Uwagi
ClR tworzy nowe zadanie automatycznie po zainicjowaniu, gdy kod użytkownika tworzy wątek przy użyciu typów w System.Threading przestrzeni nazw lub gdy rozmiar puli wątków zostanie zwiększony. Tworzy również zadania, gdy niezarządzany kod wykonuje wywołanie funkcji zarządzanej.
CreateTask umożliwia hostowi jawne żądanie utworzenia nowego zadania przez clR. Na przykład host może wywołać tę metodę, aby wstępnie zainicjować struktury danych.
Ważne
Nowe zadanie jest zwracane w stanie wstrzymania i pozostaje zawieszone do momentu jawnego wywołania hosta IHostTask::Start.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
.NET Framework wersje: dostępne od wersji 2.0
