EndTask-Funktion (winuser.h)

Artikel
08/27/2023

[Diese Funktion ist nicht für die allgemeine Verwendung vorgesehen. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Schließt das angegebene Fenster erzwungen.

Syntax

BOOL EndTask(
  [in] HWND hWnd,
  [in] BOOL fShutDown,
  [in] BOOL fForce
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das zu schließende Fenster.

[in] fShutDown

Typ: BOOL

Ignoriert. Muss FALSE sein.

[in] fForce

Typ: BOOL

Ein TRUE für diesen Parameter erzwingt die Zerstörung des Fensters, wenn bei einem ersten Versuch nicht versucht wird, das Fenster mithilfe von WM_CLOSE vorsichtig zu schließen. Mit false für diesen Parameter wird nur versucht, mit WM_CLOSE schließen.

Rückgabewert

Typ: BOOL

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

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion war erst in den SDK-Headern und -Bibliotheken enthalten, bis Windows XP mit Service Pack 1 (SP1) und Windows Server 2003. Wenn Sie keine Headerdatei und keine Importbibliothek für diese Funktion haben, können Sie die Funktion mit LoadLibrary und GetProcAddress aufrufen.

Anforderungen

Anforderung	Wert
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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll