CloseThreadpoolWait-Funktion (threadpoolapiset.h)
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 |