Función DeleteTimerQueueEx (threadpoollegacyapiset.h)

Artículo
03/05/2024

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