Função ChangeTimerQueueTimer (threadpoollegacyapiset.h)
Atualizações um temporizador de fila de temporizador criado pela função CreateTimerQueueTimer.
Sintaxe
BOOL ChangeTimerQueueTimer(
[in, optional] HANDLE TimerQueue,
[in, out] HANDLE Timer,
[in] ULONG DueTime,
[in] ULONG Period
);
Parâmetros
[in, optional] TimerQueue
Um identificador para a fila do temporizador. Esse identificador é retornado pela função CreateTimerQueue .
Se esse parâmetro for NULL, o temporizador será associado à fila do temporizador padrão.
[in, out] Timer
Um identificador para o temporizador de fila de temporizador. Esse identificador é retornado pela função CreateTimerQueueTimer .
[in] DueTime
O tempo após o qual o temporizador deve expirar, em milissegundos.
[in] Period
O período do temporizador, em milissegundos. Se esse parâmetro for zero, o temporizador será sinalizado uma vez. Se esse parâmetro for maior que zero, o temporizador será periódico. Um temporizador periódico reativa automaticamente cada vez que o período passa, até que o temporizador seja cancelado usando a função DeleteTimerQueueTimer ou redefinido usando ChangeTimerQueueTimer.
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
Essa função não pode ser chamada enquanto o thread estiver usando representação. O comportamento resultante é indefinido.
Você pode chamar ChangeTimerQueueTimer em um retorno de chamada de temporizador.
Se você chamar ChangeTimerQueueTimer em um temporizador de um tiro (seu período é zero) que já expirou, o temporizador não será atualizado.
Não chame ChangeTimerQueueTimer depois de chamar DeleteTimerQueueTimer em um identificador .
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
| 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 |