Compartir a través de


Función DeleteTimerQueueEx (threadpoollegacyapiset.h)

Elimina una cola de temporizador. Los temporizadores pendientes de la cola se cancelan y eliminan.

Sintaxis

BOOL DeleteTimerQueueEx(
  [in]           HANDLE TimerQueue,
  [in, optional] HANDLE CompletionEvent
);

Parámetros

[in] TimerQueue

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

[in, optional] CompletionEvent

Identificador del objeto de evento que se va a señalar cuando la función se realiza correctamente y se han completado todas las funciones de devolución de llamada. Este parámetro puede ser NULL.

Si este parámetro es INVALID_HANDLE_VALUE, la función espera a que se completen todas las funciones de devolución de llamada antes de devolver.

Si este parámetro es NULL, la función marca el temporizador para su eliminación y devuelve inmediatamente. Sin embargo, la mayoría de los autores de llamadas deben esperar a que se complete la función de devolución de llamada para que puedan realizar cualquier limpieza necesaria.

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 realice llamadas de bloqueo a DeleteTimerQueueEx desde dentro de una devolución de llamada del temporizador.

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

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

CreateTimerQueue

DeleteTimerQueueTimer

Funciones de sincronización

Agrupación de subprocesos

Colas del temporizador