Função CloseThreadpoolTimer (threadpoolapiset.h)
Libera o objeto de temporizador especificado.
Sintaxe
void CloseThreadpoolTimer(
[in, out] PTP_TIMER pti
);
Parâmetros
[in, out] pti
Um ponteiro para TP_TIMER estrutura que define o objeto de temporizador. A função CreateThreadpoolTimer retorna esse ponteiro.
Retornar valor
Nenhum
Comentários
O objeto de temporizador será liberado imediatamente se não houver retornos de chamada pendentes; caso contrário, o objeto de temporizador é liberado de forma assíncrona após a conclusão das funções de retorno de chamada pendentes.
Em alguns casos, as funções de retorno de chamada podem ser executadas após CloseThreadpoolTimer ter sido chamado. Para evitar esse comportamento:
- Chame a função SetThreadpoolTimer ou a função SetThreadpoolTimerEx com o parâmetro pftDueTime definido como NULL e os parâmetros msPeriod e msWindowLength definidos como 0.
- Chame a função WaitForThreadpoolTimerCallbacks com o parâmetro fCancelPendingCallbacks definido como TRUE.
- Chame CloseThreadpoolTimer.
Se houver um grupo de limpeza associado ao objeto de temporizador, não será necessário chamar essa função; chamar a função CloseThreadpoolCleanupGroupMembers libera os objetos de trabalho, espera e temporizador associados ao grupo de limpeza.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou superior.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | threadpoolapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |