Freigeben über


KillTimer-Funktion (winuser.h)

Zerstört den angegebenen Timer.

Syntax

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

Parameter

[in, optional] hWnd

Typ: HWND

Ein Handle für das Fenster, das dem angegebenen Timer zugeordnet ist. Dieser Wert muss mit dem hWnd-Wert übereinstimmen, der an die SetTimer-Funktion übergeben wird, die den Timer erstellt hat.

[in] uIDEvent

Typ: UINT_PTR

Der zu zerstörende Timer. Wenn das an SetTimer übergebene Fensterhandle gültig ist, muss dieser Parameter mit dem nIDEvent identisch sein.

An SetTimer übergebener Wert. Wenn die Anwendung SetTimer aufruft, wobei hWnd auf NULL festgelegt ist, muss dieser Parameter der von SetTimer zurückgegebene Timerbezeichner sein.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Die KillTimer-Funktion entfernt nicht WM_TIMER Nachrichten, die bereits in der Nachrichtenwarteschlange gepostet wurden.

Beispiele

Ein Beispiel finden Sie unter Zerstören eines Timers.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (einschließlich Windows.h)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-window-l1-1-2 (eingeführt in Windows 10, Version 10.0.10240)

Siehe auch

Konzept

Referenz

SetTimer

Timer

WM_TIMER