Compartir a través de


Función KillTimer (winuser.h)

Destruye el temporizador especificado.

Sintaxis

BOOL KillTimer(
  [in, optional] HWND     hWnd,
  [in]           UINT_PTR uIDEvent
);

Parámetros

[in, optional] hWnd

Tipo: HWND

Identificador de la ventana asociada al temporizador especificado. Este valor debe ser el mismo que el valor hWnd pasado a la función SetTimer que creó el temporizador.

[in] uIDEvent

Tipo: UINT_PTR

El temporizador que se va a destruir. Si el identificador de ventana pasado a SetTimer es válido, este parámetro debe ser el mismo que el nIDEvent.

valor pasado a SetTimer. Si la aplicación llama a SetTimer con hWnd establecido en NULL, este parámetro debe ser el identificador del temporizador devuelto por SetTimer.

Valor devuelto

Tipo: BOOL

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

La función KillTimer no quita WM_TIMER mensajes ya publicados en la cola de mensajes.

Ejemplos

Para obtener un ejemplo, vea Destruir un temporizador.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-window-l1-1-2 (introducido en Windows 10, versión 10.0.10240)

Consulte también

Conceptual

Referencia

SetTimer

Timers (Temporizadores)

WM_TIMER