Функция AttachConsole


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

Синтаксис

BOOL AttachConsole(

DWORD dwProcessId

);

Параметры

dwProcessId

[in] Идентификатор процесса.

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

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

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

Замечания

Вызывающая программа может вызывать любую из консольных функций. Например, графическое приложение может использовать консоль, чтобы показать на экране вывод отладочной информации.

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

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

Чтобы компилировать приложение, которое использует эту функцию, надо определить макрокоманду _WIN32_WINNT как 0x0500 или позже. Для получения дополнительной информации, см. Использование заголовочных файлов SDK.

 Смотри также

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

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

Windows .NET Server

Да

Windows XP

Да

Windows 2000

Нет

Windows NT

Нет

Windows Me

Нет

Windows 98

Нет

Windows 95

Нет

Win32s

Нет

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

Kernel32.lib

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

 

- объявлено в

Wincon.h

- включено в

Windows.h

Unicode

Нет

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

Не имеется

 

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

Hosted by uCoz