Функция FreeConsole

Отсоединяет вызывающий процесс от консоли.

Синтаксис

BOOL WINAPI FreeConsole(void);

Параметры

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

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

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

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

Замечания

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

Requirements

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхний колонтитул ConsoleApi.h (через WinCon.h, включая Windows.h)
Библиотека Kernel32.lib
DLL-библиотеки Kernel32.dll

См. также

AllocConsole

AttachConsole

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

Консоли