Función DestroyWindow (winuser.h)

Artículo
03/13/2024

Destruye la ventana especificada. La función envía WM_DESTROY y WM_NCDESTROY mensajes a la ventana para desactivarlo y quitar el foco del teclado. La función también destruye el menú de la ventana, vacía la cola de mensajes del subproceso, destruye temporizadores, quita la propiedad del Portapapeles y interrumpe la cadena del visor del Portapapeles (si la ventana está en la parte superior de la cadena del visor).

Si la ventana especificada es una ventana primaria o propietaria, DestroyWindow destruye automáticamente las ventanas secundarias o de propiedad asociadas cuando destruye la ventana primaria o propietaria. La función destruye primero las ventanas secundarias o de propiedad y, a continuación, destruye la ventana primaria o propietaria.

DestroyWindow también destruye los cuadros de diálogo modeless creados por la función CreateDialog .

Sintaxis

BOOL DestroyWindow(
  [in] HWND hWnd
);

Parámetros

[in] hWnd

Tipo: HWND

Identificador de la ventana que se va a destruir.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Un subproceso no puede usar DestroyWindow para destruir una ventana creada por otro subproceso.

Si la ventana que se destruye es una ventana secundaria que no tiene el estilo WS_EX_NOPARENTNOTIFY , se envía un mensaje WM_PARENTNOTIFY al elemento primario.

Ejemplos

Para obtener un ejemplo, vea Destruir una ventana.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll
Conjunto de API	ext-ms-win-ntuser-window-l1-1-0 (introducido en Windows 8)