DestroyWindow-Funktion (winuser.h)

Artikel
08/27/2023

Zerstört das angegebene Fenster. Die Funktion sendet WM_DESTROY und WM_NCDESTROY Nachrichten an das Fenster, um es zu deaktivieren und den Tastaturfokus daraus zu entfernen. Die Funktion zerstört auch das Menü des Fensters, leert die Threadnachrichtenwarteschlange, zerstört Timer, entfernt den Besitz der Zwischenablage und unterbricht die Zwischenablageanzeigekette (wenn sich das Fenster am oberen Rand der Viewerkette befindet).

Wenn es sich bei dem angegebenen Fenster um ein übergeordnetes Fenster oder ein Besitzerfenster handelt, zerstört DestroyWindow automatisch die zugeordneten untergeordneten oder eigenen Fenster, wenn das übergeordnete Fenster oder das Besitzerfenster zerstört wird. Die Funktion zerstört zuerst untergeordnete oder eigene Fenster und zerstört dann das übergeordnete Fenster oder das Besitzerfenster.

DestroyWindow zerstört auch moduslose Dialogfelder, die von der CreateDialog-Funktion erstellt wurden.

Syntax

BOOL DestroyWindow(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Typ: HWND

Ein Handle für das zu zerstörende Fenster.

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

Ein Thread kann destroyWindow nicht verwenden, um ein Fenster zu zerstören, das von einem anderen Thread erstellt wurde.

Wenn es sich bei dem zerstörten Fenster um ein untergeordnetes Fenster handelt, das nicht über das WS_EX_NOPARENTNOTIFY-Format verfügt, wird eine WM_PARENTNOTIFY-Nachricht an das übergeordnete Element gesendet.

Beispiele

Ein Beispiel finden Sie unter Zerstören eines Fensters.

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
APIs	ext-ms-win-ntuser-window-l1-1-0 (eingeführt in Windows 8)