Função CreateTimerQueue (threadpoollegacyapiset.h)
Cria uma fila para temporizadores. Timer-queue timers são objetos leves que permitem especificar uma função de retorno de chamada a ser chamada em um momento especificado.
Sintaxe
HANDLE CreateTimerQueue();
Retornar valor
Se a função for bem-sucedida, o valor retornado será um identificador para a fila do temporizador. Esse identificador só pode ser usado em funções que exigem um identificador para uma fila de temporizador.
Se a função falhar, o valor retornado será NULL. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Para adicionar um temporizador à fila, chame a função CreateTimerQueueTimer . Para remover um temporizador da fila, chame a função DeleteTimerQueueTimer .
Quando terminar de usar a fila de temporizadores, chame a função DeleteTimerQueueEx para excluir a fila do temporizador. Todos os temporizadores pendentes na fila são cancelados e excluídos.
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.
Exemplos
Para obter um exemplo que usa CreateTimerQueue, consulte Usando filas de temporizador.
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 |