Функция GetConsoleTitle


Функция GetConsoleTitle извлекает строку заголовка текущего консольного окна.

Синтаксис

DWORD GetConsoleTitle(

LPTSTR lpConsoleTitle, // заголовок консоли
DWORD
nSize            // размер буфера заголовка

);

Параметры

lpConsoleTitle

[out] Указатель на буфер, который принимает строку с символом нуля в конце, содержащую текст который появляется в заголовке консольного окна. Общий размер требуемого буфера, должен быть меньше чем 64КБ.

nSize

[in] Размер буфера, указанного параметром lpConsoleTitle в TCHARs.

Возвращаемые значения

Если функция завершается успешно, величина возвращаемого значения - длина строки, скопированной в буфер в TCHARs.

Если функция завершается с ошибкой, величина возвращаемого значения - ноль. Чтобы получить расширенные данные об ошибках, вызовите функцию GetLastError.

Замечания

Чтобы устанавливать строку заголовка для консольного окна, используйте функцию SetConsoleTitle.

Windows NT/2000/XP: Эта функция использует или символы Unicode или 8-разрядные символы из текущей кодовой страницы консоли. Кодовая страница консоли вначале по умолчанию является системной кодовой страницей (OEM). Чтобы изменить кодовую страницу консоли, используйте функции SetConsoleCP или SetConsoleOutputCP, или используйте команды chcp, или mode con cp select=.

Windows 95/98/Me: GetConsoleTitleW поддерживается Microsoft Layer for Unicode (Microsoft Планировщиком Уникода). Чтобы использовать это, Вы должны добавить некоторые файлы к вашему приложению, как изложено в Microsoft Планировщике Уникода для систем Windows 95/98/Me.

Смотри также

Обзор консольных приложений, Функции консоли, SetConsoleCP, SetConsoleOutputCP, SetConsoleTitle

 

Размещение и совместимость GetConsoleTitle

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Wincon.h

- включено в

Windows.h

Unicode

Реализуется как Unicode и ANSI в версиях Windows NT/2000/XP. А также поддерживает Microsoft Layer for Unicode.

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz