Compartir a través de

Función GetConsoleWindow

  • Artículo

Importante

En este documento se describe funcionalidad de la plataforma de consola que ya no forma parte de nuestro plan de desarrollo del ecosistema. No se recomienda utilizar este contenido en nuevos productos, pero seguiremos admitiendo los usos existentes en un futuro indefinido. Nuestra solución moderna preferida se centra en secuencias de terminal virtual para lograr la máxima compatibilidad en escenarios multiplataforma. Puede encontrar más información sobre esta decisión de diseño en nuestro documento de Comparación de consola clásica y terminal virtual.

Recupera el identificador de ventana que se utiliza en la consola asociada al proceso de llamada.

Sintaxis

HWND WINAPI GetConsoleWindow(void);

Parámetros

Esta función no tiene parámetros.

Valor devuelto

El valor devuelto es un identificador de la ventana que se utiliza en la consola asociada al proceso de llamada. Si no hay ninguna consola asociada, es NULL.

Comentarios

Para compilar una aplicación que utilice esta función, defina _WIN32_WINNT como 0x0500 o posterior. Para obtener más información, consulte Uso de los encabezados de Windows.

Sugerencia

Esta API no se recomienda y no tiene un terminal virtual equivalente. Esta decisión alinea intencionadamente la plataforma de Windows con otros sistemas operativos. Este estado solo es relevante para el usuario local, la sesión y el contexto de privilegios. Es posible que las aplicaciones que se comunican remotamente a través de utilidades multiplataforma y los transportes como SSH no funcionen según lo previsto si se utiliza esta API.

Cuando una aplicación está hospedada dentro de una sesión de pseudoconsola, esta función devuelve un identificador de ventana que solo se utiliza en la cola de mensajes. La ventana asociada no se muestra localmente, ya que la pseudoconsola está serializando todas las acciones en una secuencia para presentarla en una ventana de terminal distinta en otro lugar.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado ConsoleApi3.h (a través de WinCon.h, incluido Windows.h)
Biblioteca Kernel32.lib
Archivo DLL Kernel32.dll

Consulte también

Funciones de la consola