Freigeben über


TrySubmitThreadpoolCallback-Funktion (threadpoolapiset.h)

Fordert an, dass ein Threadpool-Workerthread die angegebene Rückruffunktion aufruft.

Syntax

BOOL TrySubmitThreadpoolCallback(
  [in]                PTP_SIMPLE_CALLBACK  pfns,
  [in, out, optional] PVOID                pv,
  [in, optional]      PTP_CALLBACK_ENVIRON pcbe
);

Parameter

[in] pfns

Die Rückruffunktion. Weitere Informationen finden Sie unter SimpleCallback.

[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 die Rückruffunktion 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, wird TRUE zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. 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.

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ßen von Windows.h unter Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

CallbackMayRunLong

DisassociateCurrentThreadFromCallback

FreeLibraryWhenCallbackReturns

InitializeThreadpoolEnvironment

LeaveCriticalSectionWhenCallbackReturns

ReleaseMutexWhenCallbackReturns

ReleaseSemaphoreWhenCallbackReturns

SetEventWhenCallbackReturns

Threadpools