WinMain

小甲鱼

注：本文档由 无符号整形 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

给用户提供图形化的基于窗口的应用程序的入口点。

WinMain 函数是应用程序入口点的常规名称。

更多信息，请参见备注。


API 函数原型：

注释：_In_ 说明该参数是输入的。

int CALLBACK WinMain(
  _In_ HINSTANCE hInstance,
  _In_ HINSTANCE hPrevInstance,
  _In_ LPSTR     lpCmdLine,
  _In_ int       nCmdShow
);

参数解析：

参数	含义
hInstance	指定应用程序当前实例的句柄
hPrevInstance	1. 指定一个应用程序的前一个实例的句柄 2. 此参数总是 NULL 3. 如果你需要检测另一个实例是否已经存在，使用 CreateMutex 函数创建一个唯一命名的互斥量。即使互斥量已经存在， CreateMutex 函数也会成功，但该函数将返回 ERROR_ALREADY_EXISTS 。这表示您的应用程序的另一个实例存在，因为它第一个创建互斥量。不过，在此之前，恶意用户可以创建同名互斥量，让您的应用程序无法启动。为了防止这种情况，请创建一个随机命名的互斥量并存储该名称，以便它只能被授权用户获得。或者，您可以使用一个文件用于这一目的。为了限制您的应用程序每个用户只能运行一个实例，可以创建一个在用户配置文件目录的锁定文件
lpCmdLine	1. 该应用程序的命令行，但不包括程序名称 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）所有，转载请注明来源。

yixinwenxin

耐心