DestroyWindow

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

Если заданное окно является родительским окном или окном-владельцем, то DestroyWindow автоматически разрушает дочерние окна и окна, которыми владеет данное окна, при разрушении родительского окна или окна-владельца. Сначала функция разрушает дочерние окна или окна, которыми владеет данное окно, а затем родительское окно или окно-владелец.

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

BOOL DestroyWindow(
    HWND hWnd  // дескриптор уничтожаемого окна  
   );

Параметры:

hWnd	Указывает на разрушаемое окно.

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

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

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

Замечания:

Поток не может использовать эту функцию для разрушения окна, созданного другим потоком.

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

Смотрите также:

CreateDialog, CreateWindow, CreateWindowEx, WM_DESTROY, WM_NCDESTROY, WM_PARENTNOTIFY