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指定程序的窗口应该如何显示，例如最大化、最小化、隐藏等。这个参数的值由该程序的调用者所指定，在调用ShowWindow()时可以使用到该值。

-------------------------------------------------

/*
 * ShowWindow() Commands
 */
#define SW_HIDE             0
#define SW_SHOWNORMAL       1
#define SW_NORMAL           1    激活并显示一个窗口。如果窗口被最小化或最大化，系统将其恢复到原来的尺寸和大小。应用程序在第一次显示窗口的时候应该指定此标志。
#define SW_SHOWMINIMIZED    2    激活窗口并将其最小化。
#define SW_SHOWMAXIMIZED    3    激活窗口并将其最大化。
#define SW_MAXIMIZE         3    最大化指定的窗口。
#define SW_SHOWNOACTIVATE   4    以窗口最近一次的大小和状态显示窗口。激活窗口仍然维持激活状态。
#define SW_SHOW             5    在窗口原来的位置以原来的尺寸激活和显示窗口。
#define SW_MINIMIZE         6    最小化指定的窗口并且激活在Z序中的下一个顶层窗口。
#define SW_SHOWMINNOACTIVE  7
#define SW_SHOWNA           8    以窗口原来的状态显示窗口。激活窗口仍然维持激活状态。
#define SW_RESTORE          9    激活并显示窗口。如果窗口最小化或最大化，则系统将窗口恢复到原来的尺寸和位置。在恢复最小化窗口时，应用程序应该指定这个标志。
#define SW_SHOWDEFAULT      10    依据在STARTUPINFO结构中指定的SW_FLAG标志设定显示状态，STARTUPINFO 结构是由启动应用程序的程序传递给CreateProcess函数的。
#define SW_FORCEMINIMIZE    11    在WindowNT5.0中最小化窗口，即使拥有窗口的线程被挂起也会最小化。在从其他线程最小化窗口时才使用这个参数。
#define SW_MAX              11

-------------------------------------------------

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