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的一些心得;其中不免有错误之处,其高手指出,不甚感谢!!

  • 3
    点赞
  • 0
    评论
  • 4
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

©️2021 CSDN 皮肤主题: 大白 设计师:CSDN官方博客 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值