Función SetConsoleScreenBufferInfoEx
Importante
En este documento se describe funcionalidad de la plataforma de consola que ya no forma parte de nuestra hoja de ruta del ecosistema. No se recomienda usar 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.
Establece información extendida sobre el búfer de pantalla de consola especificado.
Sintaxis
BOOL WINAPI SetConsoleScreenBufferInfoEx(
_In_ HANDLE hConsoleOutput,
_In_ PCONSOLE_SCREEN_BUFFER_INFOEX lpConsoleScreenBufferInfoEx
);
Parámetros
hConsoleOutput [in]
Identificador del búfer de pantalla de la consola. El identificador debe tener derecho de acceso de GENERIC_WRITE. Para obtener más información, consulte Seguridad y derechos de acceso del búfer de la consola.
lpConsoleScreenBufferInfoEx [in]
Una estructura CONSOLE_SCREEN_BUFFER_INFOEX que contiene la información del búfer de pantalla de la consola.
Valor devuelto
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
Sugerencia
Esta API tiene un terminal virtual parcial equivalente. El búfer de posicionamiento de cursores y los atributos de texto tienen equivalentes de secuencia específicos. La tabla de colores no es configurable, pero los colores extendidos están disponibles más allá de lo que normalmente está disponible mediante funciones de consola. Los atributos emergentes no tienen ningún equivalente, ya que los menús emergentes son responsabilidad de la aplicación cliente de la línea de comandos en el mundo del terminal virtual. Por último, el tamaño de la ventana y el estado de pantalla completa se consideran privilegios propiedad del usuario en el mundo del terminal virtual y no tienen ninguna secuencia equivalente.
Requisitos
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | ConsoleApi2.h (a través de WinCon.h, incluido Windows.h) |
| Biblioteca | Kernel32.lib |
| Archivo DLL | Kernel32.dll |