Функция
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 |
Нет |
Замечания по платформе |
Не имеется |