AllocConsole 함수
새 콘솔을 호출 프로세스에 할당합니다.
구문
BOOL WINAPI AllocConsole(void);
매개 변수
이 함수에는 매개 변수가 없습니다.
반환 값
함수가 성공하면 반환 값이 0이 아닙니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
프로세스는 하나의 콘솔에만 연결할 수 있으므로 호출 프로세스에 콘솔이 이미 있는 경우 AllocConsole 함수가 실패합니다. 프로세스에서 FreeConsole 함수를 사용하여 현재 콘솔에서 분리한 다음, AllocConsole을 호출하여 새 콘솔을 만들거나 AttachConsole을 호출하여 다른 콘솔에 연결할 수 있습니다.
호출 프로세스에서 자식 프로세스를 만드는 경우 자식은 새 콘솔을 상속합니다.
AllocConsole은 새 콘솔에 대한 표준 입력, 표준 출력 및 표준 오류 핸들을 초기화합니다. 표준 입력 핸들은 콘솔의 입력 버퍼에 대한 핸들이고, 표준 출력 및 표준 오류 핸들은 콘솔의 화면 버퍼에 대한 핸들입니다. 이러한 핸들을 검색하려면 GetStdHandle 함수를 사용합니다.
이 함수는 주로 GUI(그래픽 사용자 인터페이스) 애플리케이션에서 콘솔 창을 만드는 데 사용됩니다. GUI 애플리케이션은 콘솔 없이 초기화됩니다. 콘솔 애플리케이션은 분리된 프로세스로 만들어지는 경우를 제외하고는 콘솔을 사용하여 초기화됩니다(DETACHED_PROCESS 플래그를 사용하여 CreateProcess 함수 호출).
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 헤더 | ConsoleApi.h(WinCon.h를 통해, Windows.h 포함) |
| 라이브러리 | Kernel32.lib |
| DLL | Kernel32.dll |