プログラムはどこから始まるの？ ～ WinMain とは？

前節では単純な Windows プログラムをビルドしました。 今回はその説明です。まだビルドしていない人はぜひ自分の手で、ビルドしてみてください。

今回はこのコードを解説します。

#include <windows.h>

int WINAPI WinMain ( 
	HINSTANCE hInstance, 
	HINSTANCE hPrevInstance, 
	LPSTR lpCmdLine, 
	int nCmdShow ) {

	MessageBox( 
		NULL, 
		TEXT("Hello, world!"), 
		TEXT("Hello"), 
		MB_OK | MB_ICONINFORMATION );

	return 0;
}

Windows プログラムは WinMain から開始

結論からひとことで言うと、 リンカオプションでサブシステム (/SUBSYSTEM) を WINDOWS に指定すると、 デフォルトのエントリポイントは WinMain になります。

これはどういうことでしょうか。

リンカオプションでサブシステムを指定する、ということは簡単に言うと 「どんな環境用のコードを生成するか指定する」 ということです。 Windows 向けのコードなら WINDOWS という値を、 ウィンドウを持たないキャラクタベースのプログラムなら CONSOLE という値を、 携帯端末用のモバイル Windows 用なら WINDOWSCE という値を、それぞれ指定します。

#include <windows.h>

int WINAPI Foo ( 
	HINSTANCE hInstance, 

... 省略...

リンカオプションを次のように変えます。

LINK32_FLAGS=\
	user32.lib\
	/nologo\
	/subsystem:windows\
	/pdb:"$(OUTDIR)\$(TARGETNAME).pdb"\
	/out:"$(OUTDIR)\$(TARGETNAME).exe"\
	/DEBUG\
	/ENTRY:Foo

これを nmake でビルドすると、helloworld.exe が正常にビルドできるはずです。

念のため dumpbin コマンドで、出来上がった helloworld.exe のヘッダ情報に含まれる、 エントリポイントの情報を抽出すると、次のようになります。

> dumpbin /HEADERS .\chk\helloworld.exe | find "entry point"
            1005 entry point (00401005) @ILT+0(?Foo@@YGHPAUHINSTANCE__@@0PADH@Z)
> undname ?Foo@@YGHPAUHINSTANCE__@@0PADH@Z
Microsoft (R) C++ Name Undecorator
Copyright (C) Microsoft Corporation. All rights reserved.

Undecoration of :- "?Foo@@YGHPAUHINSTANCE__@@0PADH@Z"
is :- "int __stdcall Foo(struct HINSTANCE__ *,struct HINSTANCE__ *,char *,int)"

上記のように確かに Foo がエントリポイントに設定されていることがわかります。

上記で使った undname コマンドは、コンパイラが内部的に修飾・変更した名前を、元のシンボルに戻すコマンドです。 C++ コンパイラでは、ソースコード上で同じ名前の関数 (メソッド) が異なるパラメータを引数にとる (多態性) 必要があるため、 パラメータの情報でメソッド名が修飾されているのです。

結局 WinMain とは、Windows プログラムを作成する際、リンカがエントリポイントとして探す既定の名前だったのです。 この名前を変更する理由は通常ありませんから、「Windows プログラムは WinMain からスタートする」と覚えても問題ないでしょう。

但し、C ランタイム関数をを利用する場合にはそれが実行される前に CRT の環境設定用コードが実行されます。このページの下の補足を見てください。

尚、実はサブシステムとして CONSOLE を指定したときの、デフォルトのエントリポイントが、 main だったのです。このために、キャラクタベースのコンソールプログラムでは、main からプログラムが実行されていたのでした。