int APIENTRY WinMain( )函数的参数意义

当我们用VC6.0建立一个win32 application的时候,在接下来的对话框选择“一个简单的win32程序”,我们会看到工程只生成了一个cpp文件,里面也只有一个空的入口函数,其全部代码如下:


#include "stdafx.h"

int APIENTRY WinMain(HINSTANCE hInstance,
                     HINSTANCE hPrevInstance,
                     LPSTR     lpCmdLine,
                     int       nCmdShow)
{
  // TODO: Place code here.

 return 0;
}

 

那么问题来了,这个入口函数是什么意思呢,它的参数什么作用呢?我们来看答案:

 

WinMain

WinMain是一个函数,该函数的功能是被系统调用,作为一个32位应用程序的入口点。WinMain函数应初始化应用程序,显示主窗口,进入一个消息接收一发送循环,这个循环是应用程序执行的其余部分的顶级控制结构。

 

int WINAPI WinMain ( HINSTANCE hInstance,   HINSTANCE hPrevInstance,   LPSTR lpCmdLine,   int nCmdShow); (在Visual Studio 2005下则为int APIENTRY WinMain...)

 

hInstance:应用程序当前实例的句柄。   

hPrevlnstance:应用程序的先前实例的句柄。对于同一个程序打开两次,出现两个窗口第一次打开的窗口就是先前实例的窗口。对于一个32位程序,该参数总为NULL。如果需要检测另外一个实例是否已经存在,则使用CreateMutex函数创建一个独一无二的名字。即使互斥名已经存在,CreateMutex函数也是成功的,但是GetLastError函数将返回 ERROR_ALREADY_EXISTS,这就表明应用程序有另外一个实例存在,因为它首先创建了互斥名。   

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

nCmdShow:指明窗口如何显示。该参数可以是下列值之一:   

SW_HIDE:隐藏窗口并且激活另外一个窗口。   

SW_MINIMIZE:最小化指定的窗口,并且激活在系统表中的顶层窗口。   

SW_RESTORE:激活并显示窗口。如果窗口已经最小化或最大化,系统将以恢复到原来的尺寸和位置显示窗口(与SW_SHOWNORMAL相同)。   SW_SHOW:激活一个窗口并以原来的尺寸和位置显示窗口。   

SW_SHOWMAXIMIZED:激活窗口并且将其最大化。   

SW_SHOWMINIMIZED:激活窗口并将其目标化。   

SW_SHOWMINNOACTIVE:将一个窗口显示为图标。激活窗口维持活动状态。   

SW_SHOWNA:以窗口的当前状态显示窗口。激活窗口保持活动状态。   

SW_SHOWNOACTIVATE:以窗口的最近一次的尺寸和位置显示窗口。激活窗口维持激活状态。   

SW_SHOWNORMAL:激活并显示窗口。如果窗口最大化或最小化,系统将其恢复到原来的尺寸和位置(与SW_RESTORE相同)。   

如果函数成功,当它接收到一个WM_QUIT消息时就中止,函数应该返回在该消息的wParam参数的退出值。如果函数在进入消息循环时退出,应该返回零。   

当接收到一个WM_QUIT消息时,程序就中止。这时,WinMain函数应退出应用程序,并且返回传递给WM_QUIT消息的wParam参数的值。如果由于调用PostQuitMessage函数而接收到WM_QUIT消息,wParam的值是PostQuiMessage函数的nExitCode的值。请参看“创建一个窗口循环”。   

ANSI应用程序可以使用WinMain函数的lpCmdLine参数进入命令行字符串(除了程序名之外)。WinMain不能返回Unicode字符串的原因是IpCmdLine使用的是LPSTR数据类型,而不是LPTSTR类型。GetCommandLine函数可以用于进入命令行的Unicode字符串,因为它使用的是LPTSTR类型。   Windows CE:Windows CE不支持下列 nCmdLine参数值:

SW_MINIMIZE;SW_RESTORE;SW_RESTORE;SW_SHOWMAXMIZED   SW_SHOWMINIMIZED;SW_SHOWMINNOACTIVE   Windows NT:3.1以上版本;Windows:95以上版本:Windows CE:1.0以上版本;头文件:Winbase.h库文件:用户自定义。

你可能感兴趣的:(int APIENTRY WinMain( )函数的参数意义)