Функция GetConsoleWindow
Важно!
В этом документе описаны функции платформы консоли, которые больше не являются частью стратегии развития экосистемы. Мы не рекомендуем использовать это содержимое в новых продуктах, но мы будем продолжать поддерживать существующие использования для неопределенного будущего. Наше предпочтительное современное решение ориентировано на последовательности виртуальных терминалов для обеспечения максимальной совместимости в кроссплатформенных сценариях. Дополнительные сведения об этом решении по проектированию можно найти в классической консоли и в документе виртуального терминала .
Извлекает дескриптор окна, используемый консолью, связанной с вызывающим процессом.
Синтаксис
HWND WINAPI GetConsoleWindow(void);
Параметры
У этой функции нет параметров.
Возвращаемое значение
Возвращаемое значение — это дескриптор окна, используемого консолью, связанной с вызывающим процессом или NULL , если такой связанной консоли нет.
Замечания
Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0500 или более поздней версии. Дополнительные сведения см. в разделе "Использование заголовков Windows".
Совет
Этот API не рекомендуется и не имеет эквивалента виртуального терминала . Это решение намеренно сопоставляет платформу Windows с другими операционными системами. Это состояние относится только к локальному пользователю, сеансу и контексту привилегий. Удаленное взаимодействие приложений с помощью межплатформенных служебных программ и транспорта, таких как SSH, может не работать должным образом, если используется этот API.
Для приложения, размещенного в сеансе псевдоконсоля , эта функция возвращает дескриптор окна только для целей очереди сообщений. Связанное окно не отображается локально, так как псевдоконсол сериализует все действия в поток для презентации в другом окне терминала в другом окне терминала в другом месте.
Requirements
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Верхний колонтитул | ConsoleApi3.h (через WinCon.h, включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL-библиотеки | Kernel32.dll |