IHostThreadPoolManager::QueueUserWorkItem-Methode

Artikel
08/10/2011

Stellt eine Funktion zur Ausführung in die Warteschlange und gibt ein Objekt an, das Daten enthält, die von dieser Funktion verwendet werden sollen. Die Funktion wird ausgeführt, wenn ein Thread verfügbar wird.

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 Daten enthält, die von Function verwendet werden sollen.
Flags
[in] Einer der Flagwerte zur Ausführungssteuerung, wie sie für die Win32-QueueUserWorkItem-Methode definiert sind.

Rückgabewert

HRESULT	Beschreibungen
S_OK	QueueUserWorkItem erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (CLR) wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

QueueUserWorkItem stellt eine Arbeitsaufgabe zu einem Arbeitsthread im Threadpool in die Warteschlange. Ihre Signatur und Parametertypen sind identisch mit denen der entsprechenden Win32-Funktion, die den gleichen Namen hat. Weitere Informationen finden Sie in der Dokumentation zur Windows-Plattform.