windows核心编程 第1章 错误处理

好吧，我承认我是个很懒的人，很多内容是从别人那里复制的。。。不过加了自己的实践，有意外的地方，以后的实验的环境默认为win7x64，Visual Studio 2008，红色的一般是我出意外的地方=_=

主要参考：http://www.cppblog.com/SpringSnow/archive/2009/02/20/74350.html

       这一章开篇介绍了windows函数的几种返回值：VOID，BOOL，HANDLE，PVOID，LONG/DWORD。让我们明白，仅仅通过返回值，我们是不能清楚函数调用为什么会失败的。windows内部，函数检测到错误会采用什么机制呢？它是采用“线程本地存储区”的机制来讲相应的错误代码与“主调线程”关联到一起。它可以使不同的线程能独立运行，不会出现相互干扰对方的错误代码的情况。

错误代码：一个Windows函数返回的错误代码对了解该函数为什么会运行失败常常很有用。Microsoft公司编译了一个所有可能的错误代码的列表（存放在WinError.h头文件中），并且为每个错误代码分配了一个32位的号码；

线程本地存储器：thread-local storage，当一个Windows函数检测到一个错误时，它会使用一个称为线程本地存储器的机制，将相应的错误代码与调用的线程关联起来，这将使线程能够互相独立地运行，而不会影响各自的错误代码；

GetLastError函数：GetLastError函数返回一个32位的错误代码，它主要用于两种情况：1）确定是什么样的错误，此时当Windows函数运行失败时，应该立即调用GetLastError函数，如果调用了另一个Windows函数，它的值很可能被改写；2）搞清楚成功的原因是什么，有些Windows函数之所以能成功运行，其中的原因有很多，比如CreateEvent函数运行成功，既可能是因为你实际创建了该对象，也有可能是因为已经存在带有相同名字的事件内核对象，此时可以调用GetLastError函数可以搞清函数运行成功的原因；

SetLastError函数：SetLastError函数用于设定线程最后的错误代码，这个错误代码既可以是Windows系统自定义的（代码的第29位必须为0），也可以是用户自定义的（代码的第29位必须为1）；

FormatMessage函数：FormatMessage函数用于将错误代码转换成它的文本描述；

         函数返回的时候，其返回值会指出已发生的一个错误。

         我们查看具体是什么错误，在相应的函数执行完成后调用GetLastError()即可。

         windows中，错误有三种表示：

         一个消息ID（如ERROR_PATH_NOT_FOUND）

            消息文本（如the system cannot find the path specified）

         一个编号（尽量避免使用）

         调试程序的时候，我们可以配置watch窗口，让它始终显示线程的上一个错误代码和错误的文本描述。如 $err,hr 。hr是要显示错误代码的消息文本。

 

 

         那么我们怎么在自己的程序中显示消息文本呢？文章介绍了利用FormatMessage函数。这里我也介绍一下这个函数的用法：

         

         DWORD FormatMessage(

             DWORD dwFlags,

             LPCVOID lpSource,

             DWORD dwMessageId,

             DWORD dwLanguageId,

             LPTSTR lpBuffer,

             DWORD nSize,

             va_list* Arguments

             );

         dwFlags:

         # FORMAT_MESSAGE_ALLOCATE_BUFFER // 此函数会分配内存以包含描述字串。

         # FORMAT_MESSAGE_FROM_SYSTEM,  // 在系统的id映射表中寻找描述字串

         # FORMAT_MESSAGE_FROM_HMODULE  // 在其他资源模块中寻找描述字串

         # FORMAT_MESSAGE_FROM_STRING   // 消息ID是个字串，不是个DWORD

         #FORMAT_MESSAGE_IGNORE_INSERTS // 允许我们获得含有%占位符的消息，不传递这个标志，就必须在Arguments参数中提供这些占位符的信息

         通常为：FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM

         lpSource:

         # 指定了FORMAT_MESSAGE_FROM_HMODULE的话，此参数表示模块的HANDLE

         # 指定了FORMAT_MESSAGE_FROM_STRING的话，此参数表示id字串

         通常为：NULL

         dwMessageId:

         消息ID;如果指定FORMAT_MESSAGE_FROM_STRING，将被忽略。

         dwLanguageId:

         消息描述所用的语言

         通常为：0表示自动选择

         lpBuffer:

         #如果未指定FORMAT_MESSAGE_ALLOCATE_BUFFER，则为自己提供的缓冲区

         #否则为系统LocalAlloc分配，需要被用户LocalFree

         nSize:

         #如果未指定FORMAT_MESSAGE_ALLOCATE_BUFFER，则为自己提供的缓冲区大小

         #否则为系统LocalAlloc分配之最小缓冲区大小

         Arguments:

         通常不使用

         

         

   代码如下：      

     
     

      
       void ShowError()
     
     
     
     

      
      {
     
     
     
     

      
      	//DWORD dwError = GetLastError();
     
     
     
     

      
      	DWORD dwError = 5L;
     
     
     
     

      
      	HLOCAL hlocal = NULL;
     
     
     
     

      
      

     
     
     
     

      
      	// Use the default system locale since we look for Windows messages.
     
     
     
     

      
      	// Note: this MAKELANGID combination has 0 as value
     
     
     
     

      
      	DWORD systemLocale = MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL);
     
     
     
     

      
      

     
     
     
     

      
      	BOOL fOk = FormatMessage(
     
     
     
     

      
      		FORMAT_MESSAGE_FROM_SYSTEM | FORMAT_MESSAGE_IGNORE_INSERTS |
     
     
     
     

      
      		FORMAT_MESSAGE_ALLOCATE_BUFFER, 
     
     
     
     

      
      		NULL, dwError, systemLocale, 
     
     
     
     

      
      		(PTSTR) &hlocal, 0, NULL);
     
     
     
     

      
      

     
     
     
     

      
      	if (!fOk) {
     
     
     
     

      
      		// Is it a network-related error?
     
     
     
     

      
      		HMODULE hDll = LoadLibraryEx(TEXT("netmsg.dll"), NULL, 
     
     
     
     

      
      			DONT_RESOLVE_DLL_REFERENCES);
     
     
     
     

      
      

     
     
     
     

      
      		if (hDll != NULL) {
     
     
     
     

      
      			fOk = FormatMessage(
     
     
     
     

      
      				FORMAT_MESSAGE_FROM_HMODULE | FORMAT_MESSAGE_IGNORE_INSERTS |
     
     
     
     

      
      				FORMAT_MESSAGE_ALLOCATE_BUFFER,
     
     
     
     

      
      				hDll, dwError, systemLocale,
     
     
     
     

      
      				(PTSTR) &hlocal, 0, NULL);
     
     
     
     

      
      			FreeLibrary(hDll);
     
     
     
     

      
      		}
     
     
     
     

      
      	}
     
     
     
     

      
      

     
     
     
     

      
      	if (fOk && (hlocal != NULL))
     
     
     
     

      
      	{
     
     
     
     

      
      		
      
      //这个输出可以在VS的“输出窗口
      
      ”
      
      看到
     
     
     
     

      
                     //
      
      LocalLock锁定一个本地内存项目 并且 返回一个指向内存块第一个Byte的指针
     
     
     
     

      
      		OutputDebugString((PCTSTR) LocalLock(hlocal));
     
     
     
     

      
      		
     
     
     
     

      
      		
      
      //这里要把项目属性改为 多字节字符集，不然会出现乱码
     
     
     
     

      
      		cout<<(PCTSTR) LocalLock(hlocal)<<endl;
     
     
     
     

      
      		
     
     
     
     

      
      		LocalFree(hlocal);
     
     
     
     

      
      	}
     
     
     
     

      
      }
     
     

 

 

 visual studio 也提供了一个查询错误的小工具，为Error Lookup。通过以上的示例，我们就知道其相应的工作原理。在“工具”里可以找到。