Función ChangeTimerQueueTimer (threadpoollegacyapiset.h)

Artículo
08/26/2023

Novedades un temporizador de cola de temporizador creado por la función CreateTimerQueueTimer.

Sintaxis

BOOL ChangeTimerQueueTimer(
  [in, optional] HANDLE TimerQueue,
  [in, out]      HANDLE Timer,
  [in]           ULONG  DueTime,
  [in]           ULONG  Period
);

Parámetros

[in, optional] TimerQueue

Identificador de la cola del temporizador. La función CreateTimerQueue devuelve este identificador.

Si este parámetro es NULL, el temporizador se asocia a la cola del temporizador predeterminada.

[in, out] Timer

Identificador del temporizador de la cola del temporizador. La función CreateTimerQueueTimer Devuelve este identificador.

[in] DueTime

Hora después de la cual el temporizador debe expirar, en milisegundos.

[in] Period

Período del temporizador, en milisegundos. Si este parámetro es cero, el temporizador se señala una vez. Si este parámetro es mayor que cero, el temporizador es periódico. Un temporizador periódico se reactiva automáticamente cada vez que transcurre el período, hasta que se cancela el temporizador mediante la función DeleteTimerQueueTimer o se restablece mediante ChangeTimerQueueTimer.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

No se puede llamar a esta función mientras el subproceso usa suplantación. El comportamiento resultante no está definido.

Puede llamar a ChangeTimerQueueTimer en una devolución de llamada del temporizador.

Si llamas a ChangeTimerQueueTimer en un temporizador de un solo disparo (su período es cero) que ya ha expirado, el temporizador no se actualiza.

No llame a ChangeTimerQueueTimer después de llamar a DeleteTimerQueueTimer en un identificador.

Para compilar una aplicación que usa esta función, defina _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, vea Usar los encabezados de Windows.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	threadpoollegacyapiset.h
Library	Kernel32.lib
Archivo DLL	Kernel32.dll