AllocConsole 함수

새 콘솔을 호출 프로세스에 할당합니다.

구문

BOOL WINAPI AllocConsole(void);

매개 변수

이 함수에는 매개 변수가 없습니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

프로세스는 하나의 콘솔에만 연결할 수 있으므로 호출 프로세스에 콘솔이 이미 있는 경우 AllocConsole 함수가 실패합니다. 프로세스에서 FreeConsole 함수를 사용하여 현재 콘솔에서 분리한 다음, AllocConsole을 호출하여 새 콘솔을 만들거나 AttachConsole을 호출하여 다른 콘솔에 연결할 수 있습니다.

호출 프로세스에서 자식 프로세스를 만드는 경우 자식은 새 콘솔을 상속합니다.

AllocConsole은 새 콘솔에 대한 표준 입력, 표준 출력 및 표준 오류 핸들을 초기화합니다. 표준 입력 핸들은 콘솔의 입력 버퍼에 대한 핸들이고, 표준 출력 및 표준 오류 핸들은 콘솔의 화면 버퍼에 대한 핸들입니다. 이러한 핸들을 검색하려면 GetStdHandle 함수를 사용합니다.

이 함수는 주로 GUI(그래픽 사용자 인터페이스) 애플리케이션에서 콘솔 창을 만드는 데 사용됩니다. GUI 애플리케이션은 콘솔 없이 초기화됩니다. 콘솔 애플리케이션은 분리된 프로세스로 만들어지는 경우를 제외하고는 콘솔을 사용하여 초기화됩니다(DETACHED_PROCESS 플래그를 사용하여 CreateProcess 함수 호출).

요구 사항

참고 항목

콘솔 함수

콘솔

AttachConsole

Createprocess

FreeConsole

GetStdHandle