Share via

Функция 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

См. также

Функции консоли