DestroyWindow

Destruye la ventana especificada. La función envía mensajes WM_DESTROY y WM_NCDESTROY a la ventana para desactivarla y le quita el foco del teclado. La función también destruye el menú de la ventana, vacía la cola de mensajes de hilo, destruye los temporizadores, elimina la propiedad el portapapeles y rompe la cadena del visor del portapapeles (si la ventana es la primera de la cadena del visor).

Si la ventana especificada es una ventana padre o propietaria, DestroyWindow destruye automáticamente los hijos asociados o propias cuando destruye la ventana principal o propietaria. La función primero destruye las ventanas hijas o propias, y después destruye la ventana padre o propietaria.

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

Sintaxis

BOOL DestroyWindow(
    HWND hWnd
);

Parámetros:

hWnd: Un manipulador de la ventana a destruir.

Valor de retorno

Si la función tiene éxito, el valor de retorno es distinto de cero.

Si falla, el valor de retorno es cero. Para conseguir más información, se puede llamar a GetLastError.

Observaciones

Un hilo no puede usar DestroyWindow para destruir una ventana creada por un hilo diferente.

Si la ventana que se está destruyendo es una ventana hija que no tenga el estilo WS_EX_NOPARENTNOTIFY, se enviará un mensaje WM_PARENTNOTIFY a la ventana padre.