Share via

Função KillTimer (winuser.h)

  • Artigo

Destrói o temporizador especificado.

Sintaxe

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

Parâmetros

[in, optional] hWnd

Digite: HWND

Um identificador para a janela associada ao temporizador especificado. Esse valor deve ser o mesmo que o valor hWnd passado para a função SetTimer que criou o temporizador.

[in] uIDEvent

Tipo: UINT_PTR

O temporizador a ser destruído. Se o identificador de janela passado para SetTimer for válido, esse parâmetro deverá ser o mesmo que o nIDEvent

valor passado para SetTimer. Se o aplicativo chamar SetTimer com hWnd definido como NULL, esse parâmetro deverá ser o identificador de temporizador retornado por SetTimer.

Valor retornado

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

A função KillTimer não remove WM_TIMER mensagens já postadas na fila de mensagens.

Exemplos

Para obter um exemplo, consulte Destruindo um temporizador.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-window-l1-1-2 (introduzido no Windows 10, versão 10.0.10240)

Confira também

Conceitual

Referência

Settimer

Temporizadores

WM_TIMER