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

Confira também

CreateTimerQueue

CreateTimerQueueTimer

DeleteTimerQueueTimer

Funções de sincronização

Pool de threads

Filas de temporizador