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 |