MFC 진입점 완전 정복: WinMain이 아닌 CWinApp::InitInstance()

🔗 WinMain 함수는 어디에 있을까?

Windows 애플리케이션을 개발할 때, 일반적으로 WinMain() 함수는 프로그램의 진입점으로 동작합니다.
콘솔 프로그램에서의 main()처럼 말이죠.
하지만 MFC 기반의 프로그램에서는 개발자가 직접 WinMain을 작성하지 않아도 애플리케이션이 실행됩니다.

그 이유는 바로 Microsoft가 제공하는 MFC 라이브러리 내부에서 WinMain을 이미 구현하고 있기 때문입니다.
이 WinMain은 내부적으로 AfxWinMain() 함수를 호출하며, 여기서 사용자가 정의한 CWinApp 객체를 초기화하고 InitInstance()를 실행하게 됩니다.
즉, MFC에서는 WinMain → AfxWinMain → CWinApp 순으로 애플리케이션이 시작되는 구조인 것이죠.

💬 MFC 프로젝트를 새로 생성해도 WinMain이 보이지 않는 이유는, 이미 내부 라이브러리에 정의되어 있기 때문입니다.

결국 우리가 주목해야 할 것은 WinMain이 아닌, CWinApp 클래스의 동작 흐름입니다.
WinMain은 단순히 시작 버튼일 뿐, MFC 애플리케이션의 실질적인 제어권은 CWinApp에 있다고 봐야 합니다.

🛠️ CWinApp 클래스의 역할

MFC에서 CWinApp 클래스는 애플리케이션 전체 생명주기를 담당하는 핵심 클래스입니다.
애플리케이션이 실행될 때부터 종료될 때까지의 모든 과정을 책임지며, 다양한 이벤트 처리와 리소스 초기화 등을 내부적으로 관리합니다.

CWinApp은 보통 개발자가 직접 정의하는 클래스(MyApp 같은 이름으로 사용됨)를 통해 상속되어 구현되며, 내부에는 다음과 같은 주요 함수들이 포함됩니다.

• 🚀InitInstance() – 애플리케이션 실행 초기화
• 🧹ExitInstance() – 종료 시 정리 작업 수행
• 🗂️ProcessShellCommand() – 명령줄 인자 처리
• 🪟Run() – 메시지 루프 실행

이러한 함수들은 대부분 재정의가 가능하며, 개발자는 InitInstance()를 중심으로 윈도우 객체 생성, 리소스 로딩, 문서/뷰 구조 설정 등 주요 작업을 수행합니다.

즉, CWinApp은 단순한 실행 관리자 그 이상으로, 애플리케이션 전체의 흐름을 제어하고 방향을 잡아주는 컨트롤 타워와 같은 역할을 하는 클래스입니다.

⚙️ InitInstance는 언제 실행될까?

MFC 프로그램을 실행하면 자동으로 CWinApp::InitInstance()가 호출되며, 이 함수는 애플리케이션 초기화에 필요한 모든 작업을 처리하는 핵심 메서드입니다.
초보자들은 이 함수가 언제, 어떻게 실행되는지 가장 많이 궁금해하죠.

사실 이 과정은 MFC 내부의 AfxWinMain()에서 시작됩니다.
Visual Studio로 MFC 프로젝트를 생성하면 우리가 작성하지 않은 WinMain 함수가 존재하는데, 이 WinMain이 결국 AfxWinMain을 호출하고, 이어서 우리의 MyApp.InitInstance()를 실행합니다.

int AFXAPI AfxWinMain(...) {
    ...
    pApp->InitApplication();
    pApp->InitInstance(); // 우리가 재정의하는 부분
    ...
    return pApp->Run();
}

즉, InitInstance()는 프로그램이 실행된 직후, 메시지 루프가 돌기 전에 호출되며, 다음과 같은 작업들을 수행할 수 있습니다.

• 🪟메인 윈도우 생성 및 표시
• 📁문서/뷰 구조 설정 (SDI/MDI)
• 🧩초기 상태 로딩 및 설정값 적용

따라서 InitInstance는 단순한 초기화 함수가 아닌, 사용자와 처음 마주하는 실행 환경을 설계하는 핵심 구간이라 할 수 있습니다.

🔌 메시지 루프와의 관계

MFC 애플리케이션이 동작하는 핵심 구조는 이벤트 기반(Message-driven) 방식입니다.
사용자의 클릭, 키보드 입력, 창 크기 조절 등 모든 행동은 Windows 메시지로 전달되고, 이 메시지를 처리하는 루프가 바로 메시지 루프입니다.

MFC에서는 CWinApp::Run() 함수 내부에서 메시지 루프가 자동으로 실행되며, 이 루프는 프로그램이 종료될 때까지 사용자 입력을 기다리며 반복됩니다.
이 루프가 없으면 창은 이벤트에 반응하지 못하고, 프로그램은 “멈춘 것처럼” 보이게 됩니다.

💬 메시지 루프는 Windows 프로그래밍의 핵심 개념이며, MFC는 이 과정을 자동화해 개발자가 직접 신경 쓰지 않아도 되도록 도와줍니다.

다음은 메시지 루프의 기본적인 구조를 설명한 예시입니다.

int CWinApp::Run() {
    MSG msg;
    while (GetMessage(&msg, nullptr, 0, 0)) {
        TranslateMessage(&msg);
        DispatchMessage(&msg);
    }
    return (int) msg.wParam;
}

MFC에서는 프레임워크가 위 과정을 캡슐화하여 제공하기 때문에, 우리는 InitInstance에서 윈도우만 잘 설정해 주면 그 이후부터는 자동으로 메시지를 처리해 줍니다.
이 덕분에 개발자는 이벤트 핸들링에만 집중하면 되고, 전체 애플리케이션의 흐름은 자연스럽게 이어집니다.

💡 ExitInstance는 언제 호출될까?

MFC 애플리케이션의 종료 시점에는 CWinApp::ExitInstance()가 호출됩니다.
이 함수는 InitInstance()의 반대 역할을 수행한다고 보면 됩니다.
즉, 애플리케이션이 종료되기 직전에 호출되어 리소스를 정리하고, 마지막 정리 작업을 담당합니다.

개발자가 ExitInstance를 직접 오버라이딩(재정의)하면 다음과 같은 작업을 수행할 수 있습니다.

• 🧹동적으로 할당한 메모리 해제
• 💾설정 값 저장 또는 로그 기록
• 🔒외부 리소스(파일, 네트워크) 해제

이 함수는 Run() 함수가 메시지 루프를 종료하고 나서 호출되기 때문에, 프로그램이 완전히 닫히기 직전 단계라고 이해하면 됩니다.
만약 중요한 로그 저장이나 리소스 정리를 이곳에서 누락한다면, 예기치 않은 문제나 리소스 누수로 이어질 수 있습니다.

결론적으로, InitInstance가 프로그램을 여는 문이라면, ExitInstance는 프로그램을 깔끔하게 닫는 문이라 할 수 있겠습니다.
애플리케이션의 품질은 마지막 정리 단계에서 더욱 빛을 발합니다.

❓ 자주 묻는 질문 (FAQ)