Compartir a través de


Función CreateTimerQueue (threadpoollegacyapiset.h)

Crea una cola para temporizadores. Los temporizadores de cola de temporizador son objetos ligeros que permiten especificar una función de devolución de llamada a la que se llamará en un momento especificado.

Sintaxis

HANDLE CreateTimerQueue();

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador de la cola del temporizador. Este identificador solo se puede usar en funciones que requieren un identificador para una cola del temporizador.

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

Comentarios

Para agregar un temporizador a la cola, llame a la función CreateTimerQueueTimer . Para quitar un temporizador de la cola, llame a la función DeleteTimerQueueTimer .

Cuando haya terminado con la cola de temporizadores, llame a la función DeleteTimerQueueEx para eliminar la cola del temporizador. Los temporizadores pendientes de la cola se cancelan y eliminan.

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.

Ejemplos

Para obtener un ejemplo que usa CreateTimerQueue, consulte Uso de colas de temporizador.

Requisitos

Requisito Value
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

Vea también

CreateTimerQueueTimer

DeleteTimerQueueEx

DeleteTimerQueueTimer

Funciones de sincronización

Agrupación de subprocesos

Colas del temporizador