Freigeben über


CreateThreadpoolWork-Funktion (threadpoolapiset.h)

Erstellt ein neues Arbeitsobjekt.

Syntax

PTP_WORK CreateThreadpoolWork(
  [in]                PTP_WORK_CALLBACK    pfnwk,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Parameter

[in] pfnwk

Die Rückruffunktion. Ein Workerthread ruft diesen Rückruf jedes Mal auf, wenn Sie SubmitThreadpoolWork aufrufen, um das Arbeitsobjekt zu posten. Ausführliche Informationen finden Sie unter WorkCallback.

[in, out, optional] pv

Optionale anwendungsdefinierte Daten, die an die Rückruffunktion übergeben werden sollen.

[in, optional] pcbe

Ein Zeiger auf eine TP_CALLBACK_ENVIRON Struktur, die die Umgebung definiert, in der der Rückruf ausgeführt werden soll. Verwenden Sie die InitializeThreadpoolEnvironment-Funktion , um die Struktur zu initialisieren, bevor Sie diese Funktion aufrufen.

Wenn dieser Parameter NULL ist, wird der Rückruf in der Standardrückrufumgebung ausgeführt. Weitere Informationen finden Sie unter InitializeThreadpoolEnvironment.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie einen Zeiger auf eine TP_WORK Struktur zurück, die das Arbeitsobjekt definiert. Anwendungen ändern die Member dieser Struktur nicht.

Wenn bei der Funktion ein Fehler auftritt, gibt sie NULL zurück. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.

Beispiele

Ein Beispiel finden Sie unter Verwenden der Threadpoolfunktionen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile threadpoolapiset.h (einschließlich Windows.h)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CloseThreadpoolWork

SubmitThreadpoolWork

Threadpools

WaitForThreadpoolWorkCallbacks