Função KillTimer (winuser.h)

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

Confira também

Conceitual

Referência

Settimer

Temporizadores

WM_TIMER