CloseThreadpoolTimer-Funktion (threadpoolapiset.h)
Gibt das angegebene Timerobjekt frei.
Syntax
void CloseThreadpoolTimer(
[in, out] PTP_TIMER pti
);
Parameter
[in, out] pti
Ein Zeiger auf TP_TIMER Struktur, die das Timerobjekt definiert. Die CreateThreadpoolTimer-Funktion gibt diesen Zeiger zurück.
Rückgabewert
Keine
Bemerkungen
Das Timerobjekt wird sofort freigegeben, wenn keine ausstehenden Rückrufe vorhanden sind. Andernfalls wird das Timerobjekt asynchron freigegeben, nachdem die ausstehenden Rückruffunktionen abgeschlossen sind.
In einigen Fällen können Rückruffunktionen ausgeführt werden, nachdem CloseThreadpoolTimer aufgerufen wurde. So verhindern Sie dieses Verhalten:
- Rufen Sie die SetThreadpoolTimer-Funktion oder die SetThreadpoolTimerEx-Funktion auf, wobei der Parameter pftDueTime auf NULL und die Parameter msPeriod und msWindowLength auf 0 festgelegt sind.
- Rufen Sie die WaitForThreadpoolTimerCallbacks-Funktion auf, wobei der Parameter fCancelPendingCallbacks auf TRUE festgelegt ist.
- Rufen Sie CloseThreadpoolTimer auf.
Wenn dem Timerobjekt 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.
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 |