win32入口函数WinMain函数参数介绍

WinMain函数的定义

WinMain函数的原型声明如下：

int WINAPI WinMain(

    HINSTANCE hInstance,         // handle to current instance

    HINSTANCE hPrevInstance, // handle to previous instance

    LPSTR lpCmdLine,              // command line

    int nCmdShow                  // show state

);

WinMain函数接收4个参数，这些参数都是在系统调用WinMain函数时，传递给应用程序的。

第一个参数hInstance表示该程序当前运行的实例的句柄，这是一个数值。当程序在Windows下运行时，它唯一标识运行中的实例（注意，只有运行中的程序实例，才有实例句柄）。一个应用程序可以运行多个实例，每运行一个实例，系统都会给该实例分配一个句柄值，并通过hInstance参数传递给WinMain函数。

第二个参数hPrevInstance表示当前实例的前一个实例的句柄。通过查看MSDN我们可以知道，在Win32环境下，这个参数总是NULL，即在Win32环境下，这个参数不再起作用。

第三个参数lpCmdLine是一个以空终止的字符串，指定传递给应用程序的命令行参数。例如：在D盘下有一个sunxin.txt文件，当我们用鼠标双击这个文件时将启动记事本程序（notepad.exe），此时系统会将D:\sunxin.txt作为命令行参数传递给记事本程序的WinMain函数，记事本程序在得到这个文件的全路径名后，就在窗口中显示该文件的内容。要在VC++开发环境中向应用程序传递参数，可以单击菜单【Project】→【Settings】，选择“Debug”选项卡，在“Program arguments”编辑框中输入你想传递给应用程序的参数。

第四个参数nCmdShow指定程序的窗口应该如何显示，例如最大化、最小化、隐藏等。这个参数的值由该程序的调用者所指定，应用程序通常不需要去理会这个参数的值。

关于WinMain函数前的修饰符WINAPI，请参看下面关于__stdcall的介绍。读者可以利用goto definition功能查看WINAPI的定义，可以看到WINAPI其实就是__stdcall