AllocConsole 함수

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

문법

BOOL WINAPI AllocConsole(void);

매개 변수

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

반환 값

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

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

비고

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

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

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

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

요구 사항

참고하십시오

콘솔 함수

콘솔

AllocConsoleWithOptions

AttachConsole

CreateProcess

FreeConsole

GetStdHandle