Função DeleteTimerQueueEx (threadpoollegacyapiset.h)
Exclui uma fila de temporizador. Todos os temporizadores pendentes na fila são cancelados e excluídos.
Sintaxe
BOOL DeleteTimerQueueEx(
[in] HANDLE TimerQueue,
[in, optional] HANDLE CompletionEvent
);
Parâmetros
[in] TimerQueue
Um identificador para a fila do temporizador. Esse identificador é retornado pela função CreateTimerQueue .
[in, optional] CompletionEvent
Um identificador para o objeto de evento a ser sinalizado quando a função for bem-sucedida e todas as funções de retorno de chamada forem concluídas. Este parâmetro pode ser NULL.
Se esse parâmetro for INVALID_HANDLE_VALUE, a função aguardará a conclusão de todas as funções de retorno de chamada antes de retornar.
Se esse parâmetro for NULL, a função marcará o temporizador para exclusão e retornará imediatamente. No entanto, a maioria dos chamadores deve aguardar a conclusão da função de retorno de chamada para que eles possam executar qualquer limpeza necessária.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Não faça chamadas de bloqueio para DeleteTimerQueueEx de dentro de um retorno de chamada de temporizador.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0500 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | threadpoollegacyapiset.h |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |