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