1.1 定义自己的错误代码
(1)常见的Windows函数返回值数据类型
数据类型 |
指出函数调用失败的值 |
VOID |
这个函数不可能失败。只有极少数Windows函数的返回值类型为VOID |
BOOL |
如果函数失败,返回值为0;否则,成功时返回值非0。 ★应避免测试返回值是否为TRUE,最稳妥的做法是检查它是否不为FALSE。(因为TRUE在不同的机器上,可能值是不同的,但FALSE却都是0)。 如,if(FALSE!=func)、if(FALSE==func())、if(!func())或if(func())。 但if(TRUE==func)或if(TRUE!=func())不可取。 |
HANDLE |
失败——NULL或INVALID_HANDLE_VALUE(-1):要按MSDN函数说明来判断到底属哪种? 否则——标识一个可操纵的对象。 |
PVOID |
失败——NULL。 成功——标识一个数据块的内存地址 |
LONG/DWORD |
这种类型比例复杂。(要看MSDN中具体函数的说明) eg.返回计数的函数,如果因某种原因不能计数,通常返回0或-1。 |
(2)GetLastError——利用“线程本地存储机制”,使用每个线程的错误代码不会互相干挠,注意,这个错误代码是属于线程的。当API函数调用失败时,这个函数会设置调用该函数的线程(简称为Calling Thread)的错误代码值。即“调用线程”最近的错误代码,部分函数在成功调用时,可能用ERROR_SUCCESS改写此值。(所以,0表示操作成功,没有错误)
①为什么成功调用仍需改写这个“Last Error Code”?
有时创建对象成功,可能是因为内核中存在一个同名的事件内核对象,函数直接返回该对象。但某些情况下,我们需要知道这种情况的发生,所以特定函数调用成功时,Windows通过改写这个Last Error Code的值,用户就通过GetLastError来知道这件事或得到一些额外的信息。
②让VS始终显示线程的上一个错误代码的文本描述。
在“Watch(监视)”窗口中添加一行,在名称栏中输入“$err,hr”,其中的“,hr”表示列出错误代码的文本描述。
③错误消息:包含消息ID、消息编号、消息文本;
eg.#define ERROR_SUCCESS 0L;//消息ID为ERROR_SUCCESS,编号为0L。
(3)FormatMessage——将错误代码转换为相应的文本描述(可以转成指定语言的文本,如中文!)
参数 |
含义 |
DWORD dwFlags |
格式化选项,对lpSource参数值有指导作用 ①FORMAT_MESSAGE_ALLOCATE_BUFFER:为接收的描述字符串分配内存。 ②FORMAT_MESSAGE_FROM_SYSTEM:在系统的id映射表中寻找描述字符串 ③FORMAT_MESSAGE_FROM_HANDLE:在其他资源模块(eg.dll)中寻找描述字符串 ④FORMAT_MESSAGE_FROM_STRING:消息ID是个字符串,不是DWORD ⑤FORMAT_MESSAGE_IGNORE_INSERTS:允许我们获得含有%占位符的消息,不传递这个标志,就必须在Arguments参数中提供这些占位符信息。(即直接返回含占位符的错误文本)。 通常为:FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM |
LPCVOID lpSource |
这个值是消息资源表示来自哪里,当dwFlags为FORMAT_MESSAGE_FROM_HANDLE时该参数表示模块的句柄。为FORMAT_MESSAGE_FROM_STRING时,通常为NULL |
DWORD dwMessageId |
消息ID。如果指定了FORMAT_MESSAGE_STRING时,该项将被忽略。 |
DWORD dwLanguageId |
消息描述所用的语言。通常0表示自动选择。 |
LPTSTR lpBuffer |
如果未指定FORMAT_MESSAGE_ALLOCATE_BUFFER,则要我们自己提供缓冲区。否则为系统LocalAlloc分配,但用完后,仍需要被调用LocalFree来释放缓冲区。 |
DWORD nSize |
当指定FORMAT_MESSAGE_ALLOCATE_BUFFER时,为系统分配的最小缓冲区大小。 否则为我们指供的缓冲区的大小。(以TCHARs为单位的) |
va_list *Arguments |
在消息定义中的插入序列将会被忽略,这个标示符在获取一个格式化好的消息十分有用。如果这个标示符设置好了,那么Arguments参数将被忽略。一般可设为NULL。 |
(4)定义自己的错误代码——可用于我们自己的函数,而不是API函数。
①VOID SetLastError(DWORD dwErrCode)——错误代码的格式
位 |
31-30 |
29 |
28 |
27-16 |
15-0 |
内容 |
严重性 |
Microsoft/客户 |
保留 |
Facility代码 |
异常代码 |
含义 |
0=成功 1=信息(提示) 2=警告 3=错误 |
0=Microsoft定义的代码。 1=客户定义的代码 |
必须为0 |
前256个值由Microsoft保留。 可查看winerror.h文件 |
Microsoft/客户定义的代码 |
1.2 ErrorShow示例程序
(1)消息分流器(Messasge Craker)——使窗口过程代码更简洁,逻辑更清晰。
①HANDLE_MSG宏及问题(该宏一般用在WndProc而不能用在DlgProc中,见后面分析)
#define HANDLE_MSG(hwnd, message, fn) \
case (message): return HANDLE_##message((hwnd), (wParam), (lParam), (fn))
A、如果调用HANDLE_MSG(hwnd,WM_INITDIALOG,Dlg_InitDialog),而其中的
HANDLE_##message相当于HANDLE_WM_INITDIALOG宏,其定义如下:
#define HANDLE_WM_INITDIALOG(hwnd, wParam, lParam, fn) \
(LRESULT)(DWORD)(UINT)(BOOL)(fn)((hwnd), (HWND)(wParam), lParam)
而从上面宏定义可以看出返回值为BOOL型,该调用如果用在DlgProc中没问题,但是
B、当处理HANDLE_WM_COMMAND宏时,返回值为0L(注意逗号表达式),这对于一般的窗口过程WndProc来说WM_COMMAND中返回0没问题,但对于对话框过程来说,就出问题了,因为WM_COMMAND应return TRUE或break,而不一定是FALSE(TRUE表示该消息处理过了),这就是 HANDLE_MSG的问题!
#define HANDLE_WM_COMMAND(hwnd, wParam, lParam, fn) /
((fn)((hwnd), (int)(LOWORD(wParam)), (HWND)(lParam),
(UINT)HIWORD(wParam)), 0L)
②chHANDLE_DLGMSG宏:对于对话框消息处理过程要使用SetDlgMsgResult宏来正确返回。这就是大牛Jeffery定义的chHANDLE_DLGMSG宏,其中封装了SetDlgMsgResult。这个chHANDLE_DLGMSG宏会正确返回值或句柄。该宏一般在对话框过程中使用。
#define chHANDLE_DLGMSG(hWnd, message, fn) \
case (message): return (SetDlgMsgResult(hWnd, uMsg, \
HANDLE_##message((hWnd), (wParam), (lParam), (fn))))
//DWLP_MSGRESULT,替换内置对话框过程的返回值
#define SetDlgMsgResult(hwnd, msg, result) (( \
(msg) == WM_CTLCOLORMSGBOX || \
(msg) == WM_CTLCOLOREDIT || \
(msg) == WM_CTLCOLORLISTBOX || \
(msg) == WM_CTLCOLORBTN || \
(msg) == WM_CTLCOLORDLG || \
(msg) == WM_CTLCOLORSCROLLBAR || \
(msg) == WM_CTLCOLORSTATIC || \
(msg) == WM_COMPAREITEM || \
(msg) == WM_VKEYTOITEM || \
(msg) == WM_CHARTOITEM || \
(msg) == WM_QUERYDRAGICON || \
(msg) == WM_INITDIALOG \
) ? (BOOL)(result) : (SetWindowLongPtr((hwnd), DWLP_MSGRESULT, (LPARAM)(LRESULT)(result)), TRUE)) //(注意逗号表达式里返回的是TRUE)
可见,如果消息是中的一个,那么返回值就是我们写的fn函数的返回值,如果消息不是其中的,那么先执行SetWindowLongPtr把对话框中消息处理程序的返回值设置为fn函数的返回值,最后返回TRUE告诉对话框内置消息过程该消息己经处理过了。(根据逗号操作符特性)。
为什么要这么做呢?这些WM_CTLCOLORMSGBOX 、 WM_CTLCOLOREDIT……有什么特殊的吗? 这些消息的返回值都是有已知的且有自己含义的,对于这些消息只需要返回它们函数处理的返回值就让程序正常运行。但对于消息WM_COMMAND就很难说了,很有可能是某个控件的通知消息,需要一个值,这个值可能是零也可能不是零,所以不能像WM_CTLCOLORMSGBOX那样处理了,因为对话框过程中TRUE大部分时候代表用户处理此消息,FALSE或0代表用户没处理此消息,那么系统内置的对话框处理过程会进行默认处理。这样的话,如果一个WM_COMMAND的处理消息需要返回0,怎么办?这样办,先返回TRUE,然后用SetWindowLongPtr设置需要返回的返回值,返回TRUE是向内置对话框过程表明该消息已经处理了,但返回值最后被代替成了SetWindowlongPtr的值,这样才能正常工作。
【延伸】Windows内的对话框消息过程。
LRESULT CALLBACK DefDlgProc(HWND hdlg, UINT uMsg, WPARAM wParam, LPARAM lParam)
{
//获取自定义的对话框过程dp
DLGPROC dp = (DLGPROC)GetWindowLongPtr(hdlg, DWLP_DLGPROC);//dp为对话框过
SetWindowLongPtr(hdlg, DWLP_MSGRESULT, 0); //设置内置消息过程的返回值
INT_PTR fResult = dp(hdlg, uMsg, wParam, lParam); //调用对话框过程
//从SetDlgMsgResult可知,dp返回的是TRUE或FALSE,但真正的返回值保存在
//DWLP_MSGRESULT中。
if (fResult) return GetWindowLongPtr(hdlg, DWLP_MSGRESULT); //如果处理过了
//从SetDlgMsgResult的处理可知dp处理完后,
// SetDlgMsgResult返回TRUE给fResult,同时
// DWLP_MSGRESULT被设置我们的自定义的返回值
//然后通过Get这个返回值,返回给DefDlgProc。
else ...做默认的事... //FALSE,没处理,则进行默认处理
}
(2)FORWARD_WM_COMMAND宏
#define FORWARD_WM_COMMAND(hwnd, id, hwndCtl, codeNotify, fn) \
(void)(fn)((hwnd), WM_COMMAND, MAKEWPARAM((UINT)(id),
(UINT)(codeNotify)), (LPARAM)(HWND)(hwndCtl))
★模拟“查询”按钮点击(通过发送WM_COMMAND消息)
FORWARD_WM_COMMAND(hwnd, IDOK, GetDlgItem(hwnd, IDOK), BN_CLICKED,
PostMessage);//PostMessage为系统API
【ErrorShow程序】
/*----------------------------------------------------------------------------- Module: ErrorShow.cpp Notices: Copyright(c)2008 Jeffery Richter & Christophe Nasarre ------------------------------------------------------------------------------*/ #include "..\..\CommonFiles\CmnHdr.h" //里面包含Windows.h、CommCtrl.h和process.h #include "resource.h" #include <tchar.h> //////////////////////////////////////////////////////////////////////////////// #define ESM_POKECODEANDLOOKUP (WM_USER + 100) const TCHAR g_szAppName[] = TEXT("Error Show"); INT_PTR CALLBACK AboutDlgProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam); //////////////////////////////////////////////////////////////////////////////// BOOL Dlg_OnInitDialog(HWND hwnd, HWND hwndFocus, LPARAM lParam) { chSETDLGICONS(hwnd, IDI_ERRORSHOW); //限制错误代码在5位长度以内 Edit_LimitText(GetDlgItem(hwnd, IDC_ERRORCODE), 5); //查找命令行传入的错误代码号 SendMessage(hwnd, ESM_POKECODEANDLOOKUP, lParam, 0); return TRUE; } //根据不同的语言来显示错误文本描述 BOOL ShowErrorText(HWND hwnd,int idCtrl, DWORD dwLangID,DWORD dwError) { HLOCAL hlocal = NULL; //获得错误文本描述的缓冲区 HMODULE hDll = NULL; BOOL iRet = TRUE; //获取错误文本描述 BOOL fOk = FormatMessage( FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS | FORMAT_MESSAGE_ALLOCATE_BUFFER, NULL, dwError, dwLangID, (PTSTR)&hlocal, 0, NULL); if (!fOk) //查询失败,可能是网络相关的错误代码 { hDll = LoadLibraryEx(TEXT("netmsg.dll"), NULL, DONT_RESOLVE_DLL_REFERENCES); if (hDll != NULL) { //注意:改为FORMAT_MESSAGE_FROM_HMOUDLE,并传hdll给lpSource参数 fOk = FormatMessage( FORMAT_MESSAGE_FROM_HMODULE | FORMAT_MESSAGE_IGNORE_INSERTS | FORMAT_MESSAGE_ALLOCATE_BUFFER, hDll, dwError, dwLangID, (PTSTR)&hlocal, 0, NULL); FreeLibrary(hDll); } } iRet = fOk && (hlocal != NULL); if (iRet) { SetDlgItemText(hwnd, idCtrl, (PCTSTR)LocalLock(hlocal)); LocalFree(hlocal); } return iRet; } //////////////////////////////////////////////////////////////////////////////// //id =LOWORD(wParam); //codeNotify =HIWORD(wParam) //hwndCtrl = lParam; void Dlg_OnCommand(HWND hwnd, int id, HWND hwndCtrl, UINT codeNotity) { switch (id) { case IDC_QUIT: EndDialog(hwnd, id); break; case IDC_ABOUT: DialogBox(GetModuleHandle(NULL), MAKEINTRESOURCE(IDD_ABOUT), hwnd, AboutDlgProc); break; case IDC_ALWAYSONTOP: SetWindowPos(hwnd, IsDlgButtonChecked(hwnd, IDC_ALWAYSONTOP) ? HWND_TOPMOST:HWND_NOTOPMOST,0,0,0,0,SWP_NOMOVE | SWP_NOSIZE); break; case IDC_ERRORCODE: EnableWindow(GetDlgItem(hwnd, IDOK), Edit_GetTextLength(hwndCtrl) > 0); break; case IDOK: //获取错误代码 DWORD dwError = GetDlgItemInt(hwnd, IDC_ERRORCODE, NULL, FALSE); //使用默认语言(中文)来查看错误文本描述,MAKELANGID组合一个0值 DWORD dwLangID = MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL); if (!ShowErrorText(hwnd, IDC_ERRORTEXT_CN, dwLangID, dwError)) SetDlgItemText(hwnd, IDC_ERRORTEXT_CN, TEXT("没有发现这个错误代码的描述文本")); //使用美国英语来查看错误文本描述 dwLangID = MAKELANGID(LANG_ENGLISH, SUBLANG_ENGLISH_US); if (!ShowErrorText(hwnd, IDC_ERRORTEXT_US, dwLangID, dwError)) SetDlgItemText(hwnd, IDC_ERRORTEXT_US, TEXT("No text found for this error number.")); break; } } ////////////////////////////////////////////////////////////////////////////////// //注意,一般对话框过程是返回BOOL型的,但这里经过chHANDLG_DLGMSG宏处理后 //会返回:值或句柄 INT_PTR WINAPI Dlg_Proc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam) { switch (uMsg) { //以下两句代码在VS2013下,“IntelliSense”会提示错误,但实际上这并没错 //因为这里的WM_INIDIALOG会被“智能感知”错误地认为会被宏替宏为0x0110 //但实际上,因为chHANDLE_DLGMSG内部是通过HANDL_##message连接的,所以 //编译器仍然会正确解析。因此如果觉得不爽,可以禁用IntelliSense方法是 //工具→选项→文本编辑器→C/C++→高级→禁用IntelliSense或禁用波形曲线 chHANDLE_DLGMSG(hwnd, WM_INITDIALOG, Dlg_OnInitDialog); chHANDLE_DLGMSG(hwnd, WM_COMMAND, Dlg_OnCommand); case ESM_POKECODEANDLOOKUP: //命令行传递过来的查询代码 SetDlgItemInt(hwnd, IDC_ERRORCODE, (UINT)wParam, FALSE); //模拟“查询”按钮点击(通过发送WM_COMMAND消息) FORWARD_WM_COMMAND(hwnd, IDOK, GetDlgItem(hwnd, IDOK), BN_CLICKED, PostMessage); //该函数将创建指定窗口的线程设置到前台,并且激活该窗口 SetForegroundWindow(hwnd); break; case WM_CLOSE: EndDialog(hwnd, IDC_QUIT); break; } return FALSE; } //“关于”对话框 INT_PTR CALLBACK AboutDlgProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam) { switch (uMsg) { case WM_COMMAND: switch (LOWORD(wParam)) { case IDCANCEL: EndDialog(hwnd, 0); return TRUE; } case WM_CLOSE: EndDialog(hwnd, 0); return TRUE; } return FALSE; } //////////////////////////////////////////////////////////////////////////////// int WINAPI _tWinMain(HINSTANCE hInstExe, HINSTANCE, PTSTR pszCmdLine, int) { //第1个参数:#32270表示对话框类名,Windows内部注册的窗口类名 //第2个参数:窗口名称 HWND hwnd = FindWindow(TEXT("#32270"), TEXT("Error Show")); if (IsWindow(hwnd)) //判断定给定的窗口句柄是否标识一个已存在的窗口 { //己经存在一个正在运行的实例,激活该窗口并设置编辑框中的错误为wParam,然后查询 //int i=_ttoi("123");将字符串转为整型 SendMessage(hwnd, ESM_POKECODEANDLOOKUP, _ttoi(pszCmdLine), 0); } else DialogBoxParam(hInstExe, MAKEINTRESOURCE(IDD_ERRORSHOW), NULL, Dlg_Proc,_ttoi(pszCmdLine)); return 0; }
//{{NO_DEPENDENCIES}} // Microsoft Visual C++ 生成的包含文件。 // 供 ErrorShow.rc 使用 // #define IDD_ERRORSHOW 101 #define IDI_ERRORSHOW 102 #define IDD_ABOUT 103 #define IDC_ERRORCODE 1001 #define IDC_ALWAYSONTOP 1002 #define IDC_ERRORTEXT_CN 1003 #define IDC_ERRORTEXT_US 1004 #define IDC_ABOUT 1005 #define IDC_QUIT 1006 // Next default values for new objects // #ifdef APSTUDIO_INVOKED #ifndef APSTUDIO_READONLY_SYMBOLS #define _APS_NEXT_RESOURCE_VALUE 104 #define _APS_NEXT_COMMAND_VALUE 40001 #define _APS_NEXT_CONTROL_VALUE 1006 #define _APS_NEXT_SYMED_VALUE 101 #endif #endif
//ErrorShow.rc
// Microsoft Visual C++ generated resource script. // #include "resource.h" #define APSTUDIO_READONLY_SYMBOLS ///////////////////////////////////////////////////////////////////////////// // // Generated from the TEXTINCLUDE 2 resource. // #include "winres.h" ///////////////////////////////////////////////////////////////////////////// #undef APSTUDIO_READONLY_SYMBOLS ///////////////////////////////////////////////////////////////////////////// // 中文(简体,中国) resources #if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_CHS) LANGUAGE LANG_CHINESE, SUBLANG_CHINESE_SIMPLIFIED #ifdef APSTUDIO_INVOKED ///////////////////////////////////////////////////////////////////////////// // // TEXTINCLUDE // 1 TEXTINCLUDE BEGIN "resource.h\0" END 2 TEXTINCLUDE BEGIN "#include ""winres.h""\r\n" "\0" END 3 TEXTINCLUDE BEGIN "\r\n" "\0" END #endif // APSTUDIO_INVOKED ///////////////////////////////////////////////////////////////////////////// // // Dialog // IDD_ERRORSHOW DIALOGEX 0, 0, 245, 154 STYLE DS_SETFONT | DS_MODALFRAME | DS_FIXEDSYS | WS_POPUP | WS_CAPTION | WS_SYSMENU CAPTION "Error Show" FONT 8, "MS Shell Dlg", 400, 0, 0x1 BEGIN DEFPUSHBUTTON "查找",IDOK,125,17,40,14,WS_DISABLED LTEXT "十进制错误代码:",IDC_STATIC,15,20,76,8 CONTROL "窗口置顶",IDC_ALWAYSONTOP,"Button",BS_AUTOCHECKBOX | WS_TABSTOP,179,19,48,10 EDITTEXT IDC_ERRORTEXT_CN,16,50,212,31,ES_MULTILINE | ES_AUTOVSCROLL | ES_AUTOHSCROLL | ES_READONLY | NOT WS_BORDER,WS_EX_CLIENTEDGE EDITTEXT IDC_ERRORCODE,83,18,27,14,ES_AUTOHSCROLL | ES_NUMBER LTEXT "错误信息文本(本地语言)",IDC_STATIC,16,39,88,8 EDITTEXT IDC_ERRORTEXT_US,16,98,212,31,ES_MULTILINE | ES_AUTOVSCROLL | ES_AUTOHSCROLL | ES_READONLY | NOT WS_BORDER,WS_EX_CLIENTEDGE LTEXT "错误信息文本(美国英语)",IDC_STATIC,16,87,88,8 PUSHBUTTON "关于",IDC_ABOUT,52,132,50,14 PUSHBUTTON "退出",IDC_QUIT,127,132,50,14 END IDD_ABOUT DIALOGEX 0, 0, 165, 82 STYLE DS_SETFONT | DS_MODALFRAME | DS_FIXEDSYS | WS_POPUP | WS_CAPTION | WS_SYSMENU CAPTION "关于Error Show" FONT 8, "MS Shell Dlg", 400, 0, 0x1 BEGIN DEFPUSHBUTTON "关闭",IDCANCEL,63,57,50,14 CTEXT "Error Show 程序\n\n参照《Windows核心编程》实现。\n\nxjj1977@qq.com\n\n2015.07.06",IDC_STATIC,10,6,144,41 END ///////////////////////////////////////////////////////////////////////////// // // DESIGNINFO // #ifdef APSTUDIO_INVOKED GUIDELINES DESIGNINFO BEGIN IDD_ERRORSHOW, DIALOG BEGIN LEFTMARGIN, 7 RIGHTMARGIN, 238 TOPMARGIN, 7 BOTTOMMARGIN, 147 END IDD_ABOUT, DIALOG BEGIN LEFTMARGIN, 7 RIGHTMARGIN, 158 TOPMARGIN, 1 BOTTOMMARGIN, 79 END END #endif // APSTUDIO_INVOKED ///////////////////////////////////////////////////////////////////////////// // // Icon // // Icon with lowest ID value placed first to ensure application icon // remains consistent on all systems. IDI_ERRORSHOW ICON "ErrorShow.ico" #endif // 中文(简体,中国) resources ///////////////////////////////////////////////////////////////////////////// #ifndef APSTUDIO_INVOKED ///////////////////////////////////////////////////////////////////////////// // // Generated from the TEXTINCLUDE 3 resource. // ///////////////////////////////////////////////////////////////////////////// #endif // not APSTUDIO_INVOKED
//cmnHdr.h
/****************************************************************************** Module: CmnHdr.h Notices: Copyright (c) 2008 Jeffrey Richter & Christophe Nasarre Purpose: Common header file containing handy macros and definitions used throughout all the applications in the book. See Appendix A. ******************************************************************************/ #pragma once // Include this header file once per compilation unit //Windows版本构建选项 //////////////////////// Windows Version Build Option ///////////////////////// //因本书程序调用了一些Windows Vista中的新函数,在Vista以上必须定义_WIN32_WINNT //才能调用这些函数,否则会引起编译错误。 // = 0x0600 for VISTA level from sdkddkver.h #define _WIN32_WINNT _WIN32_WINNT_LONGHORN //_WIN32_WINNT_LONGHORN =0x0600 #define WINVER _WIN32_WINNT_LONGHORN //Unicode构建选项,本书所有程序即可编译成ANSI版本,也可编译成Unicode版本 //////////////////////////// Unicode Build Option ///////////////////////////// // Always compiler using Unicode. #ifndef UNICODE #define UNICODE #endif // When using Unicode Windows functions, use Unicode C-Runtime functions too. #ifdef UNICODE #ifndef _UNICODE #define _UNICODE #endif #endif //Windows定义和编译警告级别,警告级别越高,表示检查越严格 ///////////////////////// Include Windows Definitions ///////////////////////// #pragma warning(push, 3) //存储当前警告级别,并设置警级别为3,来编译Windows.h文件 #include <windows.h> #include <windowsx.h> //要用到SetDlgMsgResult、Edit_LimitText等宏 #pragma warning(pop) //恢复原新的警告级别 #pragma warning(push, 4) //存储当前警告级别,并设置为4级,来编译后面的内容 #include <CommCtrl.h> #include <process.h> // For _beginthreadex ///////////// Verify that the proper header files are being used ////////////// #ifndef FILE_SKIP_COMPLETION_PORT_ON_SUCCESS #pragma message("You are not using the latest Platform SDK header/library ") #pragma message("files. This may prevent the project from building correctly.") #endif //在警告级别下,允许禁用以下的警告 ////////////// Allow code to compile cleanly at warning level 4 /////////////// //允许使用非标准扩展的单行注释 /* nonstandard extension 'single line comment' was used */ #pragma warning(disable:4001) // unreferenced formal parameter #pragma warning(disable:4100) // Note: Creating precompiled header #pragma warning(disable:4699) // function not inlined #pragma warning(disable:4710) // unreferenced inline function has been removed #pragma warning(disable:4514) // assignment operator could not be generated #pragma warning(disable:4512) // conversion from 'LONGLONG' to 'ULONGLONG', signed/unsigned mismatch #pragma warning(disable:4245) // 'type cast' : conversion from 'LONG' to 'HINSTANCE' of greater size #pragma warning(disable:4312) // 'argument' : conversion from 'LPARAM' to 'LONG', possible loss of data #pragma warning(disable:4244) // 'wsprintf': name was marked as #pragma deprecated #pragma warning(disable:4995) // unary minus operator applied to unsigned type, result still unsigned #pragma warning(disable:4146) // 'argument' : conversion from 'size_t' to 'int', possible loss of data #pragma warning(disable:4267) // nonstandard extension used : nameless struct/union #pragma warning(disable:4201) ///////////////////////// Pragma message helper macro ///////////////////////// //以下的前缀ch表示Common Header的缩写 /* //为了让程序能够运行起来,可以先忽略一些代码,但在输出窗口中给予提示 When the compiler sees a line like this: //当编译器发现以下代码时,会在输出窗口中 #pragma chMSG(Fix this later) //提示“某某文件,第几个以后要修复”, //注意为了使用方便,字符串不需要加引号 it outputs a line like this: c:\CD\CmnHdr.h(82):Fix this later //提示的内容 You can easily jump directly to this line and examine the surrounding code. */ #define chSTR2(x) #x //#x,即表示把x当成字符(串)来用 #define chSTR(x) chSTR2(x) //#desc表示将desc变量当成字符串。这样输入时,可以不用加引用了。(如#pragma chMsg(这里需要修复!)) #define chMSG(desc) message(__FILE__ "(" chSTR(__LINE__) "):" #desc) //见上面的例子 ////////////////////////////// chINRANGE Macro //////////////////////////////// // This macro returns TRUE if a number is between two others //该宏用来检查一个值是否介于两个值之间 #define chINRANGE(low, Num, High) (((low) <= (Num)) && ((Num) <= (High))) ///////////////////////////// chSIZEOFSTRING Macro //////////////////////////// // This macro evaluates to the number of bytes needed by a string. //该宏用来计算字符串占用的字节总数(含\0) #define chSIZEOFSTRING(psz) ((lstrlen(psz) + 1) * sizeof(TCHAR))
//////////////////////////////// chDIMOF Macro ////////////////////////////////
// 用来统计数组中元素个数的宏
#define chDIMOF(Array) (sizeof(Array) / sizeof(Array[0]))
/////////////////// chROUNDDOWN & chROUNDUP inline functions ////////////////// // This inline function rounds a value down to the nearest multiple //计算一个数,让其最接近Value(小于等于Value,因为是向下),但这个数是Multiple的整数倍 //eg.chROUNDDOWN(10,3) =9,表示显然9最接近10,但这个数是3的倍数。 template <class TV, class TM> inline TV chROUNDDOWN(TV Value, TM Multiple) { return((Value / Multiple) * Multiple); } // This inline function rounds a value down to the nearest multiple //计算一个数,让其最接近Value(大于等于Value,因为是向上),但这个数是Multiple的整数倍 //eg.chROUNDUP(10,3) =12,表示显然12最接近10,但这个数是3的倍数。 template <class TV, class TM> inline TV chROUNDUP(TV Value, TM Multiple) { return(chROUNDDOWN(Value, Multiple) + (((Value % Multiple) > 0) ? Multiple : 0)); } ///////////////////////////// chBEGINTHREADEX Macro /////////////////////////// // This macro function calls the C runtime's _beginthreadex function. // The C runtime library doesn't want to have any reliance on Windows' data // types such as HANDLE. This means that a Windows programmer needs to cast // values when using _beginthreadex. Since this is terribly inconvenient, // I created this macro to perform the casting. typedef unsigned (__stdcall *PTHREAD_START) (void *); #define chBEGINTHREADEX(psa, cbStackSize, pfnStartAddr, \ pvParam, dwCreateFlags, pdwThreadId) \ ((HANDLE)_beginthreadex( \ (void *) (psa), \ (unsigned) (cbStackSize), \ (PTHREAD_START) (pfnStartAddr), \ (void *) (pvParam), \ (unsigned) (dwCreateFlags), \ (unsigned *) (pdwThreadId))) ////////////////// DebugBreak Improvement for x86 platforms /////////////////// //允许进程不是通过调试器启动,仍然可以停在某一个断点上。 //在Windows平台上,线程是调用DebugBreak来实现断点的,这个Kernel32.dll中的函数 //让我们在附加一个调试器到进程时,指令指针会停在那条触发断点的CPU指令上。 //因为这条指令是Kernel32.dll中的函数指令,为了调试我们的代码,可以在代码中 //嵌入汇编int 3重新定义DebugBreak函数,从而产生一个效果等价的断点功能 #ifdef _X86_ #define DebugBreak() _asm { int 3 } #endif /////////////////////////// Software Exception Macro ////////////////////////// // Useful macro for creating your own software exception codes //创建软件异常码,也就是SetLasCode中要用的异常码 #define MAKESOFTWAREEXCEPTION(Severity, Facility, Exception) \ ((DWORD) ( \ /* Severity code */ (Severity ) | \ /* MS(0) or Cust(1) */ (1 << 29) | \ /* Reserved(0) */ (0 << 28) | \ /* Facility code */ (Facility << 16) | \ /* Exception code */ (Exception << 0))) /////////////////////////// Quick MessageBox Macro //////////////////////////// //弹出一个消息对话框,对话框的标题是调用进程对应的可执行文件的完整路径名称。 inline void chMB(PCSTR szMsg) { char szTitle[MAX_PATH]; GetModuleFileNameA(NULL, szTitle, _countof(szTitle)); //模拟完整的路径名称 MessageBoxA(GetActiveWindow(), szMsg, szTitle, MB_OK); } //////////////////////////// Assert/Verify Macros ///////////////////////////// //失败时弹出对话框,并设置断点 inline void chFAIL(PSTR szMsg) { chMB(szMsg); DebugBreak(); } // Put up an assertion failure message box. //ASSERT(断言)为FALSE时,弹出消息对话框,并设置断点 inline void chASSERTFAIL(LPCSTR file, int line, PCSTR expr) { char sz[2*MAX_PATH]; wsprintfA(sz, "File %s, line %d : %s", file, line, expr); chFAIL(sz); } // Put up a message box if an assertion fails in a debug build. #ifdef _DEBUG #define chASSERT(x) if (!(x)) chASSERTFAIL(__FILE__, __LINE__, #x) //调试版,弹对话框 #else #define chASSERT(x) //发行版就不弹 #endif // Assert in debug builds, but don't remove the code in retail builds. #ifdef _DEBUG #define chVERIFY(x) chASSERT(x) #else #define chVERIFY(x) (x) //发行版时,代码不删除 #endif /////////////////////////// chHANDLE_DLGMSG Macro ///////////////////////////// //消息分流器(Messasge Craker) //一般的对话框过程只返回TRUE或FALSE来说明消息有没有被处理,而以下的宏会像 //WndProc中消息处理的LRESULT结果,返回值或句柄。该宏一般在对话框过程中使用 // The normal HANDLE_MSG macro in WindowsX.h does not work properly for dialog // boxes because DlgProc returns a BOOL instead of an LRESULT (like // WndProcs). This chHANDLE_DLGMSG macro corrects the problem: #define chHANDLE_DLGMSG(hWnd, message, fn) \ case (message): return (SetDlgMsgResult(hWnd, uMsg, \ HANDLE_##message((hWnd), (wParam), (lParam), (fn)))) //////////////////////// Dialog Box Icon Setting Macro //////////////////////// // Sets the dialog box icons //设置对话框的图标(可以以WM_INITDIALOG中调用以下函数) inline void chSETDLGICONS(HWND hWnd, int idi) { SendMessage(hWnd, WM_SETICON, ICON_BIG, (LPARAM) LoadIcon((HINSTANCE) GetWindowLongPtr(hWnd, GWLP_HINSTANCE), MAKEINTRESOURCE(idi))); SendMessage(hWnd, WM_SETICON, ICON_SMALL, (LPARAM) LoadIcon((HINSTANCE) GetWindowLongPtr(hWnd, GWLP_HINSTANCE), MAKEINTRESOURCE(idi))); } /////////////////////////// Common Linker Settings //////////////////////////// #pragma comment(linker, "/nodefaultlib:oldnames.lib") //强制编译器寻找(w)WinMain入口点函数 // Needed for supporting XP/Vista styles. //支持XP风格的用户界面主题,默认下应用程序是不支持的 #if defined(_M_IA64) #pragma comment(linker, "/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='IA64' publicKeyToken='6595b64144ccf1df' language='*'\"") #endif #if defined(_M_X64) #pragma comment(linker, "/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.6000.0' processorArchitecture='amd64' publicKeyToken='6595b64144ccf1df' language='*'\"") #endif #if defined(M_IX86) #pragma comment(linker, "/manifestdependency:\"type='win32' name='Microsoft.Windows.Common-Controls' version='6.0.0.0' processorArchitecture='x86' publicKeyToken='6595b64144ccf1df' language='*'\"") #endif ///////////////////////////////// End of File /////////////////////////////////