Compartilhar via


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

Confira também

CreateTimerQueue

DeleteTimerQueueTimer

Funções de sincronização

Pool de threads

Filas de temporizador