IHostTaskManager::CreateTask — Metoda
Żąda, aby host utworzył nowe zadanie.
Składnia
HRESULT CreateTask (
[in] DWORD stacksize,
[in] LPTHREAD_START_ROUTINE pStartAddress,
[in] PVOID pParameter,
[out] IHostTask **ppTask
);
Parametry
stacksize
[in] Żądany rozmiar w bajtach żądanego stosu lub 0 (zero) dla rozmiaru domyślnego.
pStartAddress
[in] Wskaźnik do funkcji, która ma zostać wykonana.
pParameter
[in] Wskaźnik do danych użytkownika do przekazania do funkcji lub wartość null, jeśli funkcja nie przyjmuje żadnych parametrów.
ppTask
[out] Wskaźnik do adresu wystąpienia IHostTask utworzonego przez hosta lub wartość null, jeśli nie można utworzyć zadania. Zadanie pozostaje w stanie wstrzymania, dopóki nie zostanie jawnie uruchomione przez wywołanie metody IHostTask::Start.
Wartość zwracana
| HRESULT | Opis |
|---|---|
| S_OK | CreateTask zwrócone pomyślnie. |
| HOST_E_CLRNOTAVAILABLE | Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane 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 jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE. |
| E_OUTOFMEMORY | Za mało pamięci, aby utworzyć żądane zadanie. |
Uwagi
ClR wywołuje polecenie CreateTask , aby zażądać utworzenia przez hosta nowego zadania. Host zwraca wskaźnik interfejsu IHostTask do wystąpienia. Zwrócone zadanie musi pozostać zawieszone, dopóki nie zostanie jawnie uruchomione przez wywołanie metody IHostTask::Start.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: MSCorEE.h
Biblioteki: Uwzględnione jako zasób w MSCorEE.dll
wersje .NET Framework: dostępne od wersji 2.0
