Freigeben über

IHostThreadPoolManager::QueueUserWorkItem-Methode

Stellt eine Funktion für die 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.

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 Daten enthält, die von Function.

Flags [in] Einer der Flagswerte, wie für die Win32-Methode QueueUserWorkItem definiert, die die Ausführung steuert.

Rückgabewert

HRESULT Beschreibung
S_OK QueueUserWorkItem 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 verwalteter Code nicht ausgeführt oder der Aufruf erfolgreich verarbeitet werden kann.
HOST_E_TIMEOUT Timeout des Anrufs.
HOST_E_NOT_OWNER Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine Faser darauf wartete.
E_FAIL Unbekannter katastrophaler Fehler. Wenn eine Methode E_FAIL zurückgibt, kann der CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

QueueUserWorkItem stellt eine Arbeitsaufgabe in die Warteschlange eines Arbeitsthreads im Threadpool ein. Die 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.

Kopfball: MSCorEE.h

Bibliothek: In MSCorEE.dll als Ressource enthalten

.NET Framework-Versionen: Verfügbar seit 2.0

Siehe auch

  • Last updated on