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

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

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

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

Поток не может использовать функцию DestroyWindow, чтобы уничтожить окно, созданное другим потоком.

Если разрушаемое окно - дочернее окно, которое не имеет стиля WS_EX_NOPARENTNOTIFY, родителю отправляется сообщение WM_PARENTNOTIFY.

Пример смотрите в статье Разрушение окна.

Краткий обзор Окна, CreateDialog, CreateWindow, CreateWindowEx, WM_DESTROY, WM_NCDESTROY, WM_PARENTNOTIFY