Функция DestroyWindow (winuser.h)

Статья
03/04/2024

Удаляет указанное окно. Функция отправляет WM_DESTROY и WM_NCDESTROY сообщения в окно, чтобы отключить его и удалить фокус клавиатуры. Функция также удаляет меню окна, очищает очередь сообщений потока, уничтожает таймеры, удаляет права владения буфером обмена и разрывает цепочку просмотра буфера обмена (если окно находится в верхней части цепочки просмотра).

Если указанное окно является родительским окном или окном-владельцем, DestroyWindow автоматически уничтожает связанные дочерние или принадлежащие окна при уничтожении родительского окна или окна-владельца. Функция сначала уничтожает дочерние окна или собственные окна, а затем уничтожает родительское окно или окно владельца.

DestroyWindow также удаляет немодовые диалоговые окна, созданные функцией CreateDialog .

Синтаксис

BOOL DestroyWindow(
  [in] HWND hWnd
);

Параметры

[in] hWnd

Тип: HWND

Дескриптор окна, который необходимо уничтожить.

Возвращаемое значение

Тип: BOOL

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winuser.h (включая Windows.h)
Библиотека	User32.lib
DLL	User32.dll
Набор API	ext-ms-win-ntuser-window-l1-1-0 (появилось в Windows 8)