Udostępnij za pośrednictwem


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 Functionprogram .

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

Zobacz też