IHostThreadPoolManager::QueueUserWorkItem-Methode
Fügt der Warteschlange eine auszuführende Funktion hinzu und gibt ein Objekt an, das die von der Funktion zu verwendenden Daten enthält. Die Funktion wird ausgeführt, wenn ein Thread verfügbar wird.
Syntax
HRESULT QueueUserWorkItem (
[in] LPTHREAD_START_ROUTINE Function,
[in] PVOID Context,
[in] ULONG Flags
);
Parameter
Function
[in] Ein Funktionszeiger, der die auszuführende Funktion darstellt.
Context
[in] Ein Objekt, das die von Function zu verwendenden Daten enthält.
Flags
[in] Einer der Flagwerte, wie für die Win32-Methode QueueUserWorkItem definiert, die die Ausführung steuern.
Rückgabewert
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | QueueUserWorkItem wurde erfolgreich zurückgegeben. |
| HOST_E_CLRNOTAVAILABLE | Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann. |
| HOST_E_TIMEOUT | Timeout des Aufrufs. |
| HOST_E_NOT_OWNER | Der Aufrufer besitzt die Sperre nicht. |
| HOST_E_ABANDONED | Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat. |
| E_FAIL | Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
Bemerkungen
QueueUserWorkItem fügt ein Arbeitselement in eine Warteschlange für einen Workerthread im Threadpool ein. Ihre Signatur- und Parametertypen sind mit denen der entsprechenden Win32-Funktion identisch, die denselben Namen hat. Weitere Informationen finden Sie in der Dokumentation zur Windows-Plattform.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.
.NET Framework-Versionen: Seit 2.0 verfügbar.
