WinAPI编程入门笔记

今天写的这篇文章的主要意图就是给winAPI编程实践的一个小小的启发；
因为winAPI编程时，我们用到很多的函数都是带有很多的参数，而且有时要进行相应的强制类型转换，所以熟悉常用的一些类型是非常重要的；（只有熟悉它们，我们才不会害怕!）现在好像没有一个好的,能很快速入门的方法，所以只能靠自己来琢磨了，呵呵！
废话就说到这里，让我们进入主题吧！
我们在api编程时经常会用到函数MessageBox（为什么呢？因为我们有各种各样的废话要说吗！），那就从它开始剖析吧！
函数原型：
int MessageBox(
  HWND hWnd,
  LPCTSTR lpText,
  LPCTSTR lpCaption,
  UINT uType
);
我们在用到这个函数时，我们就会发现一个问题这些参数怎么给赋值，没得好办法，参考msdn！

方法一： 参考msdn；在msdn的look for中查找相应的关键字，我们就可以发现其函数的原型及一些参数的参考！
 相关技巧，可以单击工具栏中的"Sync with Table of Contents"，跟相关的目录同步，这样我们可以参考到更多的相关信息！比如上面同步一下，我们就可以发现这个函数是在目录Dialog Boxes的目录下，在这个目录下有Dialog Box Overviews, 还有Dialog Box Reference;很多有用的信息啊，如果想深入研究的话，我们就可以慢慢地消化这些内容；但是我觉得最主要的就是能看到相关的函数，如MessageBoxEx, CreateDialog, DialogBox, .... ，以增加我们的API知识面！

方法二：代码跟踪；这是一个对API程序有更深入了解的一个捷径，也是我要介绍的重点；具体分析如下（环境：Win32 Console Application）：
 我们在进行windows编程时，vc的代码编辑环境很友好，比如有关键词的提示（在vc2005和2008中，按 ALT+右箭头 就可以出现）；我们发现MessageBox这一系列有MessageBox, MessageBoxA, MessageBoxEx, MessageBoxExA, MessageBoxExW, MessageBoxW; 很奇怪啊，在MSDN中却只有其中的两个函数，那其他几个函数到底又是什么呢，为什么在MSDN中没有被列出来啊（跟踪代码就有必要了）；
 开始跟踪！对任意一个函数，在其函数名上点击右键，选择"Go To Definition"， Ok, 进入到源代码，这个时处于WinUser.h的头文件中的，找到关心的代码，摘抄如下！

WINUSERAPI
int
WINAPI
MessageBoxA(
    __in_opt HWND hWnd,
    __in_opt LPCSTR lpText,
    __in_opt LPCSTR lpCaption,
    __in UINT uType);
WINUSERAPI
int
WINAPI
MessageBoxW(
    __in_opt HWND hWnd,
    __in_opt LPCWSTR lpText,
    __in_opt LPCWSTR lpCaption,
    __in UINT uType);
#ifdef UNICODE
#define MessageBox  MessageBoxW
#else
#define MessageBox  MessageBoxA
#endif // !UNICODE

#if defined(_M_CEE)
#undef MessageBox
__inline
int
MessageBox(
    HWND hWnd,
    LPCTSTR lpText,
    LPCTSTR lpCaption,
    UINT uType
    )
{
#ifdef UNICODE
    return MessageBoxW(
#else
    return MessageBoxA(
#endif
        hWnd,
    lpText,
    lpCaption,
    uType
        );
}
#endif  /* _M_CEE */

WINUSERAPI
int
WINAPI
MessageBoxExA(
    __in_opt HWND hWnd,
    __in_opt LPCSTR lpText,
    __in_opt LPCSTR lpCaption,
    __in UINT uType,
    __in WORD wLanguageId);
WINUSERAPI
int
WINAPI
MessageBoxExW(
    __in_opt HWND hWnd,
    __in_opt LPCWSTR lpText,
    __in_opt LPCWSTR lpCaption,
    __in UINT uType,
    __in WORD wLanguageId);
#ifdef UNICODE
#define MessageBoxEx  MessageBoxExW
#else
#define MessageBoxEx  MessageBoxExA
#endif // !UNICODE

粗略地看一下，能被比较清晰地看出来的是：MessageBox是对MessageBoxA和MessageBoxW的封装， MessageBoxEx是对MessageBoxExA和MessageBoxExW的封装；具体是与字符编码有关的（是根据UNICODE得到的结论！）, 我们知道，A是Ascii的缩写，MessageBoxA和MessageBoxExA用于输出字母型的字符串； 而W代表的是UNICODE（我暂时不清楚是什么的缩写，就理解为Wide的缩写吧，意思是Unicode比Ascii码占用的空间大），MessageBoxW和MessageBoxExW用于输出汉字等类型的字符串；MessageBox和MessageBoxEx封装了上述的函数，也就是说我们在消息输出时，就不必关系编码问题了；至于这两个函数直接的区别wLanguageId的细节就不多说了，大家可以参考MSDN；
接着，我们会对这几个函数的声明中的几个词有点困惑：WINUSERAPI, WINAPI；那就继续跟踪之！！
还是点击右键，选择"Go To Definition"，同样WinUser.h的头文件中找到：
#if !defined(_USER32_)
#define WINUSERAPI DECLSPEC_IMPORT
#define WINABLEAPI DECLSPEC_IMPORT
#else
#define WINUSERAPI
#define WINABLEAPI
#endif
.....
.....

#if (defined(_M_IX86) || defined(_M_IA64) || defined(_M_AMD64)) && !defined(MIDL_PASS)
#define DECLSPEC_IMPORT __declspec(dllimport)
#else
#define DECLSPEC_IMPORT
#endif
粗略得知，WINUSERAPI可以简单地看做就是关键字 __declspec(dllimport);
再来跟踪WINAPI，找到代码如下：
#define WINAPI      __stdcall；
然后再综合看一个函数：
WINUSERAPI
int
WINAPI
MessageBoxA(
    __in_opt HWND hWnd,
    __in_opt LPCSTR lpText,
    __in_opt LPCSTR lpCaption,
    __in UINT uType);
变为：
__declspec(dllimport)
int
__stdcall
MessageBoxA(
    __in_opt HWND hWnd,
    __in_opt LPCSTR lpText,
    __in_opt LPCSTR lpCaption,
    __in UINT uType);
发现这个函数是从动态链接库链入的一个函数；并且遵循__stdcall的函数调用原则；返回值为int型；函数的功能为显示一个对话框！它是用于显示字母型字符串消息的！它被MessageBox封装！对MessageBox的相关参数解释可以参考MessageBox！
这里想对这个函数更深入说明的是：函数的动态链接库性质和调用原则！
我们知道，我们的API函数都是从动态链接库中引入的，最重要的两个动态链接库是：
user32.dll 和 Kernel32.dll, 所以这里的的函数必然也是从动态链接库中链入的；MessageBoxA,MessageBoxW,MessageBoxExA,MessageBoxExW都是从动态链接库user32.dll中链入的； 我们用dumpbin -exports对user32.dll进行剖析时发现，这个dll有731个函数，其中上述函数的hint值分别为 1DF, 1E6, 1E0, 1E1;
然后就是对__stdcall的一个粗略的介绍，目的是对这个关键词不要恐惧；其实，函数的调用方式是有很多种的，具体体现在：参数的调用方式和返回值的方式，可以是通过压栈，也可以通过寄存器传递等；这样的话，就有必要对各种调用方式进行规范；我们这里提到的__stdcall调用规范主要是：
1）Argument-passing order：          Right to left.
2）Argument-passing convention：     By value, unless a pointer or reference type is passed.
3）Stack-maintenance responsibility：Called function pops its own arguments from the stack.
4）Name-decoration convention：      An underscore (_) is prefixed to the name. The name is followed by the at sign (@) followed by the number of bytes (in decimal) in the argument list. Therefore, the function declared as int func( int a, double b ) is decorated as follows: _func@12
5）Case-translation convention：     None

最后：The __stdcall calling convention is used to call Win32 API functions，所以，我们在调用Win32 API时，这个关键字总是出现的！
其他相关的关键字为：
__cdecl用于C/C++; 
__clrcall用于修饰托管代码;
__fastcall用于修饰用寄存器传递参数的函数，调用速度很快，所以就fast!
__thiscall用于修饰C++成员函数的调用；

用两种方法剖析函数后，我们对函数有了一个比较深入的了解；接下来，我们就可以进入实战阶段了！呵呵，这才是最主要的啊！！！
我们来显示一个消息吧：
 MessageBox(NULL,"hello, world!", "hello",MB_OK);
发现一个错误：
error C2664: 'MessageBoxW' : cannot convert parameter 2 from 'const char [14]' to 'LPCWSTR'
        Types pointed to are unrelated; conversion requires reinterpret_cast, C-style cast or function-style cast
分析错误我们可以得出，一、MessageBox调用了API函数MessageBoxW，第二，就是类型转换有问题！ 这里就给一个类型转换的宏 __T(x) 或是 _T(x); 其实就是在字符串前加一个L,
例如上面的函数可以写做：
 MessageBox(NULL, _T("hello, world!"), _T("hello"),MB_OK);
 MessageBox(NULL,__T("hello, world!"),__T("hello"),MB_OK);
 MessageBox(NULL,  L"hello, world!"  ,   L"hello" ,MB_OK);
因为只是输出英文，所以还可以写做：
 MessageBoxA(NULL,  "hello, world!"  ,     "hello",MB_OK);
是不是更简单；

最后想说的就是关于windows API编程的环境问题；
windows API编程目前我所了解的可以用四种方式来编程：一、用.net库；二、用MFC； 三、用Run-Time库；四、直接调用；
用.net库，是我最想用的，因为托管代码的十分安全高效，并且语言十分优美，还有很多的工具可用，MSDN帮助也很多，是编程的趋势，但是要对那个库有足够的了解，需要一定的学习时间；MFC个人有点排斥，可能是对其了解甚少的原因吧，但是一点是很重要的，学习MFC是要一定的时间的，相比于.net库，是一个落后的技术了；直接调用是一个挑战，可以在Win32汇编时用，对于了解windows底层是有帮助的；目前，我最崇拜的是Run-Time库的运用；它是对windows API的一个简单的封装（不像MFC，太过了），让我们有更多的机会去接触API，并且比汇编代码简洁，最主要的是入门相比上面的.net，MFC都简单；
现在，我介绍一下我的环境吧，就是建立一个Windows Console Application；然后包含一个windows.h头文件；具体编译的环境什么的，还在学习ing；
 以上的内容是我学习API的一些心得；其中不免有错误之处，其高手指出，不甚感谢！！