API.docx

1、API大家好再次自我介绍一下我是beyondcode,这次心血来潮,计划着做一系列关Windows API编程的教程，用于帮助一些在Windows API编程上有疑惑的，纳闷的，迷惑的新手朋友们。先解释一些术语或名词吧。SDK是Software Development Kit的简写，也就是软件开发包的意思，其中就包含了我们写程序要用到的一些头文件，库，工具，帮助文档之类的。Windows API编程是指调用Windows的接口函数来进行程序的编写，例如MessageBox就是一个API函数或者说接口函数。怎么说都可以，自己理解就行。如果你连这个都不太懂，我想也不会搜到这篇文章了吧。为什么做这个

2、系列教程呢，请听我一一道来先，最近遇到一些事一些人，让我真的感觉在这方面的引导入门文章真的很是匮乏，加上Windows SDK头文件中那些复杂，庞大，烦人的宏定义与数据类型定义，对于一个新手来说(我所说的新手不单只刚接触编程的，还特指那些在其他语言领域有比较高 造诣的朋友) 一个纯SDK写的helloworld程序都算是一个有些困难和挑战的任务了吧。 本着帮助别人,高兴自己的原则，我有了这个打算，当然对自己以前所学，所经历做一次回忆，也是这次计划的一部分。声明一下，本系列教程是面向广大初次接触WIN32 SDK程序编写的新手朋友们的，如果你是高手，一笑而过吧当然，除了一笑而过，也多谢你们提出指

3、正文章中的错误，以免我误人子弟啊谢谢Ok 废话不多说，进入正题，今天第一篇，讲什么? 对于一个新人来说，第一次接触SDK编程或者说API编程，什么最迷惑你们的，我们讲它，我觉得Windows SDK中那烦人的数据类型定义和宏定义应该算这个很角色吧。其 实微软的本意也是善良的，为了减轻程序员的负担，和为了编程的方便，才花了那么多心思与精力定义出了这么一大套数据类型与宏定义，这也是我为什么在之前说 它烦人都是加上引号的原因，因为他不是真的烦人，熟练了，你不但不觉得它烦，反而离不开它了，呵呵，日久深情也就是这么来的。呵呵 先看几个数据类型定义吧typedef float FLOAT;typedef

4、long LONG;typedef short SHORTtypedef int INT;typedef char CHAR;float, long, short, int, char 这几个数据类型都是大家熟悉的C/C+的数据类型吧，微软将他们重新定义了一下，很简单，就是改变名字为大写了，这样做的目的大概是微软为了编码的方便吧，输入法大小写都不用切换了，多人性化呀 呵呵。再看几个数据类型定义的例子typedef unsigned int UINT;typedef unsigned int UINT32;typedef signed int INT32;typedef unsigned lon

5、g DWORD;typedef unsigned short WORD;这些数据类型的定义就稍微有实质性作用一些了，注意观察，他们都比较短了，不用写那么长了，而且也还比较直观，如果我要定义一个无符号整形， 我就不用写 unsigned int a;这么长了，只需UINT a; 多简单， 多明了，所以我说其实不烦人吧。其 中DWORD 算是SDK程序中可以经常看见的一个数据类型了，经常被使用，很多新手也就不明白，这是什么数据类型啊，现在看到了吧，其实就是无符号长整形 unsigned long，给他取了个外号而已没什么技术含量，所以不用怕，程序中究竟是写unsigned long 还是DWORD

6、都看你自己心情，因为他们都代表同一种数据类型。下面再介绍2个很重要的，经常被使用到的，无处不在的数据类型WPARAM,LPARAM先看看他们定义吧typedef LONG_PTR LPARAM;typedef UINT_PTR WPARAM;先告诉你，这2个数据类型很重要，不是危言耸听，以后你写SDK程序就知道了，看他们的定义如上，有些迷糊? 别，我们一步一步分析,我们分析LPARAM。首先定义LPARAM 为LONG_PTR也就是用LPARAM的地方也就可以写成LONG_PTR，LONG_PTR又是被定义成什么的呢?typedef long LONG_PTR;看到了吗?也就是long 所以归

7、根结底，LPARAM 就是long型，所有LPARAM型的变量，你都可以直接使用long数据类型代替。不过不推荐这样，至于为什么，各位思考思考呢以上这些数据类型是参考MSDN中的说明，或者可以查看WinDef.h这个头文件查看这些Windows数据类型的定义，那么也请各位自己推推看LARAM和WPARAM的真面目吧各位朋友在推导的过程中可能发现LONG_PTR的定义是这样写的#if defined(_WIN64)typedef _int64 LONG_PTR; #elsetypedef long LONG_PTR;#endif这是什么意思呢，能看懂英文都能知道这在定义些什么,如果定义了_WIN

8、64这个宏 那么就定义LONG_PTR为_int64，否则定义LONG_PTR为long。 很简单吧也就是说如果_WIN64这个宏在前面被定义了，那么这里的LONG_PTR就被定义为_int64这个在64位编程下的数据类型，否则就定义为long型，这样说应该比较好理解了吧。在这里，各位就不必深究_int64了，在目前的主流32位编程下很少使用它啦。理解就ok了。这样定义是微软为了程序员编写的程序能在32位与64位下都能编译而采用的伎俩。有关这些Windows的数据类型，想查看他们的真面目，其实很简单，在VC6.0,VS2008 这些集成开发环境里面，你只需要在一个数据类型上面点击右键，在弹出菜

9、单中选择Goto Defination 或者是 查看定义就可以看到了，如果看到的还不是最终面目，在继续上面步骤。直到看到它的本质数据类型为止。通过这样，新手对于Windows的这些复杂的数 据类型定义也就有了根本的认识，不再是迷迷糊糊，在以后的编程中也就不会出现不知道用哪种数据类型或者哪些数据类型之间可以相互转换的情况了。不过还需要多多观察与练习才是啊下面再来看一看windows中定义的一些宏#define VOID void#define CONST const2个最简单的宏，也是只变成大写而已，难道又是为了方便程序员不切换输入法？还真的人性化呀。Windows SDK中的宏定义是最庞大的，

10、最复杂的，但也是最灵活的，为什么这样说，先不告诉你，我会在以后的系列文章中一点一点的讲解，累积，因为太多了，也比较复 杂，我们就采取在需要用到的时候才讲解它，目前看来还没这个必要了解那么多，就了解上面2个很简单的好了，像其他如：WINAPI CALLBACK GetWindowText 这些宏现在讲了不但记不住还会增加你们的负担。,我们就在以后要用到的时候再做讲解。到这里第一篇系列文章的内容也就差不多了。新手朋友们哪些地方迷惑的，提出来，我可以考虑是否加在后续的文章中进行解说。本SDK系列入门教程需要你们的支持。谢谢。By - beyondcode今天，开始第二篇文章，这章我准备介绍一下Win

11、dows平台下编程中Unicode编码和ASCII编码的相关问题。不知道各位新手朋友们遇到这样的问题没有呢，新建一个Windows应用程序，调用MessageBox这个函数，准备让它弹出一段提示文本，可是编译器在编译的时候却报错说，不能将constchar*或者constchar转换为constwchar_t*之类的提示呢，很多刚接触WindowsAPI编程的朋友们在这里可能就卡住了，不知如何下手解决了，其实，这就是Unicode编码和ASCII编码的问题了。我下面就会一一道来关于Unicode和ASCII具体的编码是怎么的，我这里就不详细介绍了，也介绍不了，如果需要深入了解，网上有很多这方面

12、的专门文章，我这里就只对Unicode编码和ASCII编码在Windows平台下的编程相关的内容进行介绍。我 们都知道Unicode和ASCII最大的区别就是Unicode采用2个字节来存储一个字符，不管是英文，汉字，还是其他国家的文字，都有能用2个字节 来进行编码，而ASCII采用一个字节存储一个字符，所以对于英文的编码，那是足够的了，可是对于汉字的编码，则必须采用一些特殊的方法，用2个 ASCII字符来表示一个汉字。我 们在写程序的过程中，势必要和字符打交道，要输入，获取，显示字符，到底是选用Unicode字符呢还是ASCII字符呢，这都是各位自己的权利。但为了 程序的通用性和符合目前操作

13、系统的主流趋势，Unicode编码是被推荐的。由于Unicode字符要比ASCII字符占用的空间大一倍，编译出来的程序 在体积上和占用的内存上必定要大一些，不过这并不是什么很大的问题。所以微软目前的SDK中保留了2套API，一套用于采用Unicode编码处理字符的 程序的编写，一套用于采用ASCII编码处理字符的程序的编写。例如，我们上面提到的MessageBox，它其实不是一个函数名，而是一个宏定义，我 们先来看看它是怎么被定义的，再来讨论它。#ifdefUNICODE#defineMessageBoxMessageBoxW#else#defineMessageBoxMessageBoxA#

14、endif看 到了吗?很简单是不是,如果定义了UNICODE这个宏那么就定义MessageBox为MessageBoxW，如果没有定义UNICODE 这个宏，那么就定义MessageBox为MessageBoxA，MessageBox后面的W和A就是代表宽字节(Unicode)和 ASCII，这样，其实存在于SDK中的函数是MessageBoxW和MessageBoxA这两个函数.MessageBox只 是一个宏而已。所以在程序中，这3个名字你都可以使用，只不过需要注意的是，使用MessageBoxA的话，那么你要注意传给它的参数，字符都必须是单 字节，也就是ASCII，在程序中就是char，

15、如果使用MessageBoxW的话，那么，字符都必须使用Unicode，程序中就 是wchar_t。但是这样有个非常不方便的地方那就是，如果你使用W后缀系列的函数的话，那么你的程序使用的字符就是Unicode字符编码的，但 是如果你需要用这个程序的源代码编译出字符采用ASCII编码的程序，那么需要改动的地方就太大了。凡是涉及到字符操作的地方都需要改变。那么，有没有 比较好的办法不做更改就可以用同样的代码编译出ASCII版本的程序呢。当 然有，就是我们在编程的时候尽量使用不带后缀的宏定义，如上例，就使用MessageBox,其中的参数也不明确使用char还是wchar_t而是 使用微软给我们定义

16、的TCHAR字符数据类型，它的定义和上面MessageBox函数的定义差不多，都是根据是否定义了UNICODE这个宏来判断是将 TCHAR定义为char还是wchar_t，所以这样一来，这个TCHAR的数据类型就是可变的了，它根据工程的设置而定义为相应的最终字符类型，这样 我们的程序就可以不做任何更改就可以轻松的编译出另外一个版本的了。是不是非常方便。前 面2篇文章纯文字的介绍比较多，因为很多是概念性的，需要理解，后面的文章我准备配合一些小示例程序，使用一些简单的API函数，遇到的相关的概念在一并 介绍的方法进行。所以，前2篇文章如果各位朋友不是很能理解，不用担心，影响不是很大，经过后面的学习

17、，你就会慢慢的理解前面所说的内容了。本打算通 过前面两篇文章的讲解，后来的系列就可以通过使用一些简单的，常用的API写一些示例程序的讲解进行，但是发现还有一个不得不先讲一讲的要 点，Windows下和字符串操作有关的数据类型。我看留言中也有几位朋友提到了，那我就在这篇中讲它吧。不会很枯燥的，各位慢慢看下去就是了。 下面我罗列一些我们在Windows平台下编程经常使用到的和字符或字符串有关的数据类型。char和wchar_t这两个类型大家绝对不会陌生吧，一个是单字节的字符类型，一个是宽字节的字符类型(也就是Unicode字符)。charc=b;wcha_twc=Lb;上 面我就分别定义了2个变量

18、c和wc，相信第一个定义大家都看的懂，就是定一个字符变量c，其中保存了b这个字符。那么第二个呢?我相信还是很 多人都看的懂，要是你看不懂也没关系，现在就告诉你，也是定义一个字符变量wc，只不过这个字符变量是Unicode字符变量，用2个字节来保存一个字 符，而上面的c这个字符变量只有一个字节来保存，那么在b前面的L又是什么意思呢，它就表示这里的b这个字符是一个Unicode字符，所以第二 个定义的意思就是将Lb这个Unicode字符保存到wc这个Unicode字符变量中。如果我要定义一个字符数组怎么定义呢?用分别用单字节的char和宽字节的wchar_t来定义就应该是：char c10;wch

19、ar_t wc10;如果是要带初始化的字符数组的声明，我们来看看怎么写char c=beyondcode;wchar_t wc=Lbeyondcode;看到了吗，宽字节的操作其实和单字节的字符操作一样吧，只是在前面加上L表示是宽字节的字符或者字符串。上 面都是属于C/C+中的知识，并没有涉及太多Windows中的数据类型，那么各位朋友们在Windows编程中看到的满到处都是 的TCHAR,LPSTR,LPCSTR,LPWSTR,LPCWSTR,LPTSTR,LPCTSTR这些数据类型又是怎么回事呢?别 急，我们一步一步的来，最后我会联系到那上面去的。上面的你都知道或者是理解了的话，那我们继续，

20、除了可以声明一个字符数组，我还可以定义一个字符指针变量来指向一个字符数组，当然这个字符数组可以是Unicode的宽字节字符数组，也可以是单字节字符数组，如下：char c=hellobeyondcode; /定义一个字符数组wchar_twc=Lhellobeyondcode; /定义一个宽字节字符数组char *p=c; /定义一个字符指针，指向刚才的字符数组wchar_t *wp=wc; /定义一个宽字节字符指针，指向刚才的宽字节字符数组这样之后，我就可以通过指针来改变刚才我们定义的2个数组，例如：p0=H;wp0=LH;把上面2个数组的第一个字符通过指针改变成大写。这里是可以通过指针来修

21、改的，因为我没有定义指针为常量指针，也就是没有加const修饰符。如果我像下面这样定义的话，那么就不能通过这些指针来改变他们所指向的数据了，而是只有读取他们。constchar*p=c;constwchar_t*wp=wc;上面将的都是C/C+的基础知识，有点啰嗦，为了照顾新手朋友们嘛，下面我们就来看看Windows是怎么定义它的数据类型的首先，定义了CHAR,WCHAR的这2个字符数据类型，就是我们上面讨论的两个字符数据类型改了一下名字而已。现在你还不昏吧typedefchar CHAR;typedefwchar_t WCHAR;然后，用刚才定义的CHAR,WCHAR这2个字符数据类型去定义

22、了一系列其他字符指针类型。typedefCHAR*LPSTR;typedefWCHAR*LPWSTR;这 样一定义之后，LPSTR的就是CHAR*，而CHAR又是char，所以LPSTR的本质就是char*，也就是我们上面熟悉的不能再熟悉的 字符指针,那LPWSTR不用我推导，相信你也推导出来了吧。不过我还是推导一下，LPWSTR是WCHAR*，WCHAR是 wchar_t，这样LPWSTR就是wchar_t*，也就是我们上面讨论的宽字节字符指针。上面这些定义都是在WinNT.h这个头文件中定义 的，读者朋友们有兴趣在这个头文件里面去挖掘挖掘吧，上面2个定义我只是提取了重要的部分，其实在里面他

23、还定义了其他很多别名.看了LPSTR,LPWSTR是怎么一回事之后，我们再接再厉，看看LPCSTR,LPCWSTR这2个数据类型又是怎么一回事呢,老规矩，先看windows的定义。typedefCONSTCHAR*LPCSTR;typedefCONSTWCHAR*LPCWSTR;和 上面的比较，名字中就多了一个大写的C，这个C的含义就代表是const修饰符,也就是我们上面所说的常量指针，指向的内容不能通过这个指针被改变，但可 以读取。定义中的大写的CONST也是一个宏，我在第一篇文章中就讲过了，代换出来也就是const，所以请读者自己推导一下这两个数据类型的本质是什 么。所 以，在window

24、s平台下的编程过程中，凡是可以使用char*的地方，你都可以使用LPSTR来代替，凡是可以使用wchar_t*的地方，你都可 以使用LPWSTR来代替，至于怎么用，还是那句老话，看你个人心情，只不过Windows的API函数中关于字符串的都是使用LP这种数据类型。但是你 还是可以给他传递char*或者wchar_t*,只要他们的本质是一样的，那怎么不可以呢下面，我们来看一看一些示例。char c=c;和CHARc=c; 是一样的wchar_t wc=Lw;和WCHARwc=Lw; 是一样的char*p和LPSTRp 是一样的wchar_t*wp和LPWSTRwp 是一样的再来看看动态内存分配怎

25、么写的呢char*p=newchar10; /动态分配了十个字符也可以写成CHAR*p=newCHAR10;LPSTRp=newCHAR10;LPSTRp=newchar10;宽字节的再来一次wchar_t*wp=newwchar_t10;也可以写成下面这些形式WCHAR*wp=newWCHAR10;LPWSTRwp=newWCHAR10;LPWSTRwp=newwchar_t10;上面定义的这些字符指针p,wp都没有用const修饰符，所以可以通过他们来修改他们所指向的内容。这里留给读者一个问题，怎么定义有const修饰符的字符指针呢，都可以用什么形式来写呢，写得越多越好哟。通过上面这些，我

26、想你大概已经了解了LPSTR,LPCSTR,LPWSTR,LPCWSTR这四个数据类型了，他们无非就是:LPSTR -char*LPCSTR - constchar*LPWSTR - wchar_t*LPCWSTR - constwchar_t*下 面我提一个问题，如果你在你的程序中使用的字符串都是通过LPWSTR,LPCWSTR这种宽字节(Unicode)字符指针来进行操作的，那么在 Unicode环境下编译，完全没有问题，如果这时你需要编译一套ASCII版本的程序，那你会怎么办呢？你说将用LPWSTR和LPCWSTR 的地方全部换成LPSTR和LPCSTR，再将字符串前面的L去掉就可以了，

27、对，这是一种方法，但是！所有人在这里都应该知道我要说但是，这也太麻烦了 吧。难道没有通用点的方法吗?有！所有人在这里也都知道我会说有，呵呵。那就是使用微软的通用数据类型,说通用数据类型有点太专业了，其 实也就那样，请听我慢慢分析来。我在上一篇文章中说过，凡是涉及字符串操作的API函数有2套，一个A系列的,一套W系列的，还有一套宏，能根据不同的工 程环境定义成不同的API函数名。那么在字符类型上微软也使用几乎同样的技术，定义了一套宏能根据不同的工程环境定义成不同的字符数据类型。我上面就提到 过的TCHAR,LPTSTR,LPCTSTR就是这样的类型。首先说说TCHAR，它是被这样定义的：#ifd

28、efUNICODEtypedefWCHARTCHAR;#elsetypedefchar TCHAR看到了吗?它也是根据UNICODE这个宏被定义没有，如果被定义了，那么TCHAR代表的数据类型就是WCHAR，也就是wchar_t，如果没被定义，那么TCHAR就代表的是char同样LPTSTR,LPCTSTR也是这样的，考虑到篇幅，我就只列出LPTSTR来给大家看看了#ifdefUNICODEtypedefLPWSTR LPTSTR;#elsetypedefLPSTR LPTSTR;这 个是我简化了的定义，真实面目有些复杂，不过意思也是如此，有兴趣可以自己看看，在WinNT.h这个头文件中。下面

29、再次解释一下上面这个LPTSTR的 定义,还是老样子，根据UNICODE这个宏被定义与否来决定怎么定义LPTSTR，如果是定义了UNICODE这个宏，表示当前工程环境是 Unicode环境，那么LPTSTR就被定义为了LPWSTR，LPWSTR就是我们前面所讲的wchar_t*，所以此时LPTSTR代表的数据 类型就是wchar_t*，如果这时的工程没有定义UNICODE这个宏，那么就定义LPTSTR为LPSTR，而LPSTR就是我们前面所说的 char*，所以这是的LPTSTR就代表char*。懂了吗?各位，我都觉得自己有些啰嗦了不好意思然后还有一个宏需要讲一下，由于我们使用通用数据类型，那

30、么我事先就不知道我的源代码需要在Unicode下编译还是在ASCII环境下编译,所以如下这种情况TCHARtc=a;或者是TCHARtc=La;是否合适呢？前面我已经说过了字符或字符串常量前面加L代表这是宽字节的字符或字符串，将一个宽字节字符赋值给一个TCHAR数据类型的变量tc，什么情况下是正确的呢?各位思考一下呢?如果当前工程是Unicode环境，那么TCHAR数据类型就是wchar_t的宽字节类型，所以tc就是宽字节字符变量，那么上面第二个赋值语句就是正确的，而第一个就是错误的。如果反过来，当前的工程是ASCII环境，那么TCHAR代表的是char这种数据类型，那么第一个赋值语句就是正确的，而第二个就是错误的了。分析了这么多，我就是要讲一个宏_T(),只要将字符或者字符串常量放在_T()这个宏里面，那么这个宏就能根据当前的环境决定是否在字符或字符串前面加L，如下面：TCHARtc=_T(A);如果这么写，在不需要改写源代码的情况下，就可以编译出Unicode和ASCII两套程序而只需要改变工程的环境而已。这篇文章的内容大概就这么多了，关于后续文章的内容安排，我会适当采纳各位朋友的留言来进行安排。在这里我介绍的是Windows平台下的和字符串操作有关的数据类型，至于MFC中的CStrin