다음을 통해 공유


FreeConsole 함수

호출 프로세스를 콘솔에서 분리합니다.

구문

BOOL WINAPI FreeConsole(void);

매개 변수

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

반환 값

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

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

설명

프로세스는 최대 하나의 콘솔에 연결할 수 있습니다. 프로세스는 FreeConsole 함수를 사용하여 콘솔에서 자신을 분리할 수 있습니다. 다른 프로세스가 콘솔을 공유하는 경우 콘솔은 제거되지 않지만 FreeConsole이라는 프로세스는 콘솔을 참조할 수 없습니다. 콘솔에 연결된 마지막 프로세스가 종료되거나 FreeConsole을 호출하면 콘솔이 닫힙니다. 프로세스가 FreeConsole을 호출한 후 AllocConsole 함수를 호출하여 새 콘솔을 만들거나 다른 콘솔에 연결할 AttachConsole을 만들 수 있습니다. 호출 프로세스가 아직 콘솔 에 연결되지 않은 경우 FreeConsole 요청은 여전히 성공합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
헤더 ConsoleApi.h(WinCon.h를 통해, Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

AllocConsole

AttachConsole

콘솔 함수

콘솔