CloseThreadpoolWait-Funktion (threadpoolapiset.h)

Artikel
03/02/2024

Gibt das angegebene Wait-Objekt frei.

Syntax

void CloseThreadpoolWait(
  [in, out] PTP_WAIT pwa
);

Parameter

[in, out] pwa

Ein Zeiger auf eine TP_WAIT-Struktur , die das Wait-Objekt definiert. Die CreateThreadpoolWait-Funktion gibt diesen Zeiger zurück.

Rückgabewert

Keine

Bemerkungen

Das Wait-Objekt wird sofort freigegeben, wenn keine ausstehenden Rückrufe vorhanden sind. Andernfalls wird das Timerobjekt asynchron freigegeben, nachdem die ausstehenden Rückrufe abgeschlossen sind.

In einigen Fällen können Rückruffunktionen ausgeführt werden, nachdem CloseThreadpoolWait aufgerufen wurde. So verhindern Sie dieses Verhalten:

Rufen Sie die SetThreadpoolWait-Funktion oder die SetThreadpoolWaitEx-Funktion auf, wobei der h-Parameter auf NULL festgelegt ist.
Rufen Sie die WaitForThreadpoolWaitCallbacks-Funktion auf, wobei der Parameter fCancelPendingCallbacks auf TRUE festgelegt ist.
Rufen Sie CloseThreadpoolWait auf.

Wenn dem Wait-Objekt eine Bereinigungsgruppe zugeordnet ist, ist es nicht erforderlich, diese Funktion aufzurufen. Durch Aufrufen der CloseThreadpoolCleanupGroupMembers-Funktion werden die arbeits-, warte- und timer-Objekte freigegeben, die der Bereinigungsgruppe zugeordnet sind.

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