Функция AllocConsole

Функция AllocConsole назначает новую консоль для вызывающего процесса.

Синтаксис

BOOL AllocConsole(void);

Параметры

У этой функции нет параметров.

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

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

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

Замечания

Процесс может быть связан с только одной консолью, так что функция AllocConsole завершается ошибкой, если вызывающий процесс уже имеет консоль. Процесс может использовать функцию FreeConsole, чтобы отключить себя от своей текущей консоли, затем он может вызывать функцию AllocConsole, чтобы создать новую консоль или функцию AttachConsole, чтобы подключиться к другой консоли.

Если вызывающий процесс создает дочерний процесс, ребенок наследует новую консоль.

Функция AllocConsole инициализирует стандартный ввод данных, стандартный вывод и обработку стандартной ошибки для новой консоли. Дескриптор стандартного ввода – это дескриптор буфера ввода консоли, а дескрипторы стандартного вывода, и стандартной ошибки – это дескрипторы экранного буфера консоли. Чтобы получить эти дескрипторы, используйте функцию GetStdHandle.

Эта функция, главным образом, используется приложением GUI, чтобы создать консольное окно. Прикладные программы GUI инициализируются без консоли. Консольные программы инициализируются с консолью, если они не созданы как отключенные процессы (при помощи вызова функции CreateProcess с флажком DETACHED_PROCESS).

Смотри также

Обзор консольных приложений, Функции консоли, AttachConsole, CreateProcess, FreeConsole, GetStdHandle

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

Windows. NET Server

Да

Windows XP Да

Windows 2000

Да

Windows NT

Версия 3.1 и выше

Windows Me

Да

Windows 98

Да

Windows 95

Да

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

Kernel32.lib

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

 

- объявлено в

Wincon.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz