Функция AllocConsole

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

Синтаксис

BOOL WINAPI AllocConsole(void);

Параметры

Эта функция не имеет параметров.

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

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

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

Замечания

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

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

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

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

Требования

Минимальный поддерживаемый клиент	Windows 2000 Профессиональный [только классические приложения]
Минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
Заголовок	ConsoleApi.h (через WinCon.h, включая Windows.h)
Библиотека	Файл Kernel32.lib
DLL	Kernel32.dll

См. также

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

консоли

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle