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

Confira também

CreateThreadpoolTimer

IsThreadpoolTimerSet

SetThreadpoolTimer

SetThreadpoolTimerEx

Pools de threads

WaitForThreadpoolTimerCallbacks