IHostThreadPoolManager::QueueUserWorkItem — Metoda
Kolejkuje funkcję do wykonania i określa obiekt zawierający dane, które mają być używane przez tę funkcję. Funkcja jest wykonywana, gdy wątek stanie się dostępny.
Składnia
HRESULT QueueUserWorkItem (
[in] LPTHREAD_START_ROUTINE Function,
[in] PVOID Context,
[in] ULONG Flags
);
Parametry
Function
[in] Wskaźnik funkcji reprezentujący funkcję do wykonania.
Context
[in] Obiekt, który zawiera dane, które mają być używane przez Function
program .
Flags
[in] Jedna z wartości flag, zgodnie z definicją dla metody Win32 QueueUserWorkItem
, która kontroluje wykonywanie.
Wartość zwracana
HRESULT | Opis |
---|---|
S_OK | QueueUserWorkItem 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. |
Uwagi
QueueUserWorkItem
kolejkuje element roboczy do wątku roboczego w puli wątków. Jego typy podpisów i parametrów są identyczne z typami odpowiadających funkcji Win32, która ma taką samą nazwę. Aby uzyskać więcej informacji, zobacz dokumentację platformy systemu Windows.
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