WinMain
注:本文档由 无符号整形 翻译,小甲鱼校对。原文链接 -> 传送门
函数功能:
给用户提供图形化的基于窗口的应用程序的入口点。
WinMain 函数是应用程序入口点的常规名称。
更多信息,请参见备注。
API 函数原型:
注释:_In_ 说明该参数是输入的。
int CALLBACK WinMain(
_In_ HINSTANCE hInstance,
_In_ HINSTANCE hPrevInstance,
_In_ LPSTR lpCmdLine,
_In_ int nCmdShow
);
参数解析:
参数 含义
hInstance指定应用程序当前实例的句柄
hPrevInstance1. 指定一个应用程序的前一个实例的句柄
2. 此参数总是 NULL
3. 如果你需要检测另一个实例是否已经存在,使用 CreateMutex 函数创建一个唯一命名的互斥量。即使互斥量已经存在, CreateMutex 函数也会成功,但该函数将返回 ERROR_ALREADY_EXISTS 。这表示您的应用程序的另一个实例存在,因为它第一个创建互斥量。不过,在此之前,恶意用户可以创建同名互斥量,让您的应用程序无法启动。为了防止这种情况,请创建一个随机命名的互斥量并存储该名称,以便它只能被授权用户获得。或者,您可以使用一个文件用于这一目的。为了限制您的应用程序每个用户只能运行一个实例,可以创建一个在用户配置文件目录的锁定文件
lpCmdLine1. 该应用程序的命令行,但不包括程序名称
2. 如果需要检索整个命令行,请调用 GetCommandLine 函数
nCmdShow控制窗口是如何显示的,此参数可以是下列值之一:
值 含义
SW_HIDE(0) 隐藏窗口,并激活另一个窗口
SW_MAXIMIZE(3) 最大化指定的窗口
SW_MINIMIZE(6) 最小化指定窗口并按 Z 顺序激活下一个窗口
SW_RESTORE(9) 激活并显示窗口。如果窗口被最小化或最大化,系统把它恢复到原来的大小和位置。当恢复最小化窗口时,应用程序应该指定此标志
SW_SHOW(5) 激活窗口,并让它显示当前的大小和位置
SW_SHOWMAXIMIZED(3) 激活窗口并将其最大化
SW_SHOWMINIMIZED(2) 激活窗口并将其最小化
SW_SHOWMINNOACTIVE(7) 显示窗口并最小化窗口。这个值与 SW_SHOWMINIMIZED 相似,不同之处在于它不激活窗口
SW_SHOWNA(8) 显示当前大小和位置。这个值类似于 SW_SHOW ,不同之处在于它不激活窗口
SW_SHOWNOACTIVATE(4) 将显示一个窗口在其最近的大小和位置。这个值类似于 SW_SHOWNORMAL,不同之处在于它不激活窗口
SW_SHOWNORMAL(1) 激活并显示一个窗口。如果窗口被最小化或最大化,系统把它恢复到它原来的大小和位置。应用程序应该在第一次显示窗口时指定该这个标志
返回值:
如果程序执行成功,并且它收到一个 WM_QUIT 消息时,它应该返回包含在该消息的 wParam 参数的值。如果程序在进入消息循环之前终止,它应该返回 0。
备注:
1. WinMain 是被许多编程框架使用的约定入口点。根据不同的编程框架,调用 WinMain 函数可以在前面和后面,特定于该框架的附加活动。
2. 你的 WinMain 应初始化应用程序,显示其主窗口,然后进入一个消息循环循环,应用程序执行代码。当接收到一个 WM_QUIT 消息时,终止消息循环。在这一点上,你的 WinMain 函数应该返回并退出应用程序,返回在 WM_QUIT 消息的 wParam 参数的值。收到 WM_QUIT 消息是调用 PostQuitMessage 函数的结果, wParam 参数的值是 PostQuitMessage 函数的 nExitCode 参数的值。有关详细信息,请查看创建一个消息循环。
3. ANSI 应用程序可以使用 WinMain 函数的参数 lpCmdLine 访问命令行字符串(不包括应用程序名称)。注意: lpCmdLine 参数使用 LPSTR 数据类型,而不是 LPTSTR 数据类型,这意味着 WinMain 函数不能被 Unicode 应用程序使用。但是 GetCommandLineW 函数可以用来获取 Unicode 字符串的命令行。一些编程框架可能会提供一种替代的入口点,提供一个 Unicode 的命令行。例如,微软的 Visual Studio C++ 编译器使用 wWinMain 名称为 Unicode 应用程序的入口点。
需求:
Minimum supported client Windows 2000 专业版 [仅桌面应用程序]
Minimum supported server Windows 2000 服务器版 [仅桌面应用程序]
Header Winbase.h (包含于 Windows.h)
【API档案】版权归鱼C工作室(www.fishc.com)所有,转载请注明来源。
耐心
页:
[1]