CloseThreadpoolTimer-Funktion (threadpoolapiset.h)

Artikel
03/06/2024

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