Función GetConsoleWindow
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 |