Función CloseThreadpoolTimer (threadpoolapiset.h)
Libera el objeto de temporizador especificado.
Sintaxis
void CloseThreadpoolTimer(
[in, out] PTP_TIMER pti
);
Parámetros
[in, out] pti
Puntero a TP_TIMER estructura que define el objeto de temporizador. La función CreateThreadpoolTimer devuelve este puntero.
Valor devuelto
None
Observaciones
El objeto de temporizador se libera inmediatamente si no hay devoluciones de llamada pendientes; de lo contrario, el objeto de temporizador se libera de forma asincrónica una vez completadas las funciones de devolución de llamada pendientes.
En algunos casos, las funciones de devolución de llamada se pueden ejecutar después de llamar a CloseThreadpoolTimer . Para evitar este comportamiento:
- Llame a la función SetThreadpoolTimer o a la función SetThreadpoolTimerEx con el parámetro pftDueTime establecido en NULL y los parámetros msPeriod y msWindowLength establecidos en 0.
- Llame a la función WaitForThreadpoolTimerCallbacks con el parámetro fCancelPendingCallbacks establecido en TRUE.
- Llame a CloseThreadpoolTimer.
Si hay un grupo de limpieza asociado al objeto de temporizador, no es necesario llamar a esta función; Al llamar a la función CloseThreadpoolCleanupGroupMembers , se liberan los objetos de trabajo, espera y temporizador asociados al grupo de limpieza.
Para compilar una aplicación que use esta función, defina _WIN32_WINNT como 0x0600 o superior.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [aplicaciones de escritorio | aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | threadpoolapiset.h (incluya Windows.h en Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |