Freigeben über


InitializeThreadpoolEnvironment-Funktion (winbase.h)

Initialisiert eine Rückrufumgebung.

Syntax

void InitializeThreadpoolEnvironment(
  [out] PTP_CALLBACK_ENVIRON pcbe
);

Parameter

[out] pcbe

Eine TP_CALLBACK_ENVIRON-Struktur , die eine Rückrufumgebung definiert.

Rückgabewert

Keine

Bemerkungen

Standardmäßig wird ein Rückruf im Standardthreadpool für den Prozess ausgeführt. Der Rückrufumgebung ist keine Bereinigungsgruppe zugeordnet, der Aufrufer ist dafür verantwortlich, dass die DLL des Rückrufs geladen bleibt, während ausstehende Rückrufe vorhanden sind, und es wird erwartet, dass der Rückruf in einer angemessenen Zeit für die Anwendung ausgeführt wird.

Erstellen Sie eine Rückrufumgebung, wenn Sie eine der folgenden Funktionen aufrufen möchten, um die Umgebung zu ändern:

Um die Standardrückrufumgebung zu verwenden, legen Sie den optionalen Rückrufumgebungsparameter beim Aufrufen einer der folgenden Funktionen auf NULL fest: Die InitializeThreadpoolEnvironment-Funktion wird als Inlinefunktion implementiert.

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 winbase.h (einschließlich Windows.h)

Weitere Informationen

DestroyThreadpoolEnvironment

SetThreadpoolCallbackCleanupGroup

SetThreadpoolCallbackLibrary

SetThreadpoolCallbackPool

SetThreadpoolCallbackRunsLong

Threadpools