KillTimer

9/9/2008

Essa função destrói o timer especificado. O sistema procura o fila de mensagens para qualquer pendente WM_TIMER Mensagens associado com o timer e remove-los.

Syntax

BOOL KillTimer(
  HWND hWnd, 
  UINT uIDEvent 
); 

Parameters

• hWnd
  [no] Identificador para a janela associado com o timer especificado. Este valor deve ser igual a hWnd valor passado para o SetTimer função que criou o timer.

• uIDEvent
  [no] Especifica o identificador do timer para ser destruídos. Se o identificador janela passado para SetTimer é válido, esse parâmetro deve ser igual a uIDEvent valor passado para SetTimer. Se o aplicativo chama SetTimer Com hWnd Definir como NULL, este parâmetro deve ser o identificador timer retornado por SetTimer.

Return Value

Nonzero indica sucesso. Zero indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Após o timer termina, você poderá não Mensagens WM_TIMER get, independentemente de se o timer foi acionado.

Os timers são mantidos em uma lista na fila de mensagens. Se não houver nenhum outra prioridade mais alta mensagens postada, a lista é procurada por timers que tem acionado. Se um timer foi acionado uma mensagem WM_TIMER é retornada no GetMessage. Quando KillTimer é chamado, o timer é removido da lista imediatamente. O próximo tempo GetMessage é chamado será impossível para uma mensagem WM_TIMER a partir de timer get porque ele não está mais na lista de fila de mensagens de timers.

Se a pasta uElapse parâmetro da SetTimer função é definida como infinito, KillTimer Falha ao destruir o timer.

Requirements

Header	winbase.h
Windows Embedded CE	Windows CE 1.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

SetTimer
WM_TIMER
GetMessage