运用Detours库hook API

Detours库类似于WTL的来历，是由Galen Hunt and Doug Brubacher自己开发出来，于99年7月发表在一篇名为《Detours: Binary Interception of Win32 Functions.》的论文中。基本原理是改写函数的头5个字节（因为一般函数开头都是保存堆栈环境的三条指令共5个字节：8B FF 55 8B EC）为一条跳转指令，直接跳转到自己的函数开头，从而实现API拦截的。后来得到MS的支持并在其网站上提供下载空间：

http://research.microsoft.com/research/downloads/Details/d36340fb-4d3c-4ddd-bf5b-1db25d03713d/Details.aspx

        目前最新的版本是：Detours Express 2.1。

二、Detours的使用准备：

        Detours库是以源码形式提供的，这给我们的使用带来极大的方便。你可以选择把它编译成库、也可以直接把源码加入工程……形式使用。农夫采取的方法是编译成库后使用的。编译库的方法很简单，下载包中已经制作好了makefile，我们只须直接用vc下的nmake工具直接编译即可。鉴于前段时间在网上看见有部分朋友对此也存疑惑，农夫在此“浪费”一下空间，详细解说一下编译的过程（括号中为本人的例子）：

1、运行你下载的安装包，把文件解压到磁盘上

       此处建议您把解压后的src文件夹拷贝到VC的安装目录的VC98子目录下（D:/SDK/6.0/VC98）。对于像我一样使用库的方式会有好处，稍后即讲：）。

2、编译并设置开发环境

        在你刚才拷贝过去的src文件夹下建立一个*.bat文件，里面填上“../bin/nmake”内容后保存即可。运行该批处理文件，恭喜您：库已经编译完成，唯一要做的是要把../bin/Detoured.dll拷贝到您的系统目录下。现在您的工程里面包含如下文件即可运用Detours库来进行开发了：

#include <detours.h>

#pragma comment(lib, "detours.lib")
#pragma comment(lib, "detoured.lib")

         对于没有把src文件拷贝过来的朋友，也不用着急。bat文件中把路径用全路径即可进行编译。不过你除了拷贝.dll文件外，还得要把.lib、.h文件拷贝到VC目录下，或者在你的VC环境中设置这些文件的包含路径，才可正常使用VC进行开发。看，是不是要麻烦些？

        另外的建议：在Detours.h文件中定义一个函数指针类型，到用的时候您就知道会很方便了：

         typedef  LONG (WINAPI* Detour)(PVOID*, PVOID);

三、几个重要的函数：

1、DetourAttach & DetourDetach

        这两个函数就是实际实现API挂钩的（改写头5个字节为一个跳转指令），前一个实现API拦截，后一个为在不需要的时候恢复原来的API。

        第一个参数为自己定义的一个用于保存原来系统API的函数，该函数就相当于您没挂钩时的API。农夫习惯于在原有API的基础上加以“Sys”前缀来命名；

        第二个参数为自己拦截API的功能函数，您想干什么“坏事”都是在这个函数中实现的。农夫习惯于在原有API的基础上加以“Hook”前缀来命名。

2、DetourCreateProcessWithDll

       该函数是在以DLL注入方式拦截API时使用的，它其实就是封装“CreateProcess”，以“CREATE_SUSPEND”方式创建进程，然后修改IAT，把Detoured.dll和您的*.dll插入到它的导入表，然后再启动进程。所以它的参数就是在普通的CreateProcess基础上增加了两个DLL的路径参数，最后一个参数为创建进程的函数指针，默认为CreateProcessA！这点要特别注意：如果您的程序拦截了该函数，而在HookCreateProcessA中又调用DetourCreateProcessWithDll函数的话，一定要在此传入SysCreateProcessA，否则您的程序就会递归调用了，当心您的程序崩溃！至于为何要这么调用？呵呵，问我干嘛？：）

        当然其它的API也很有用，不过对于开发者来说，这三个最重要！

四、开发实例：

         随源码有一个帮助文档，上面列举了很多例子：包含普通的API、类成员函数、COM接口、DLL方式注入……。包含了我们的大多应用领域。

         下面举个拦截CreateFileA函数的例子。该例子将所有创建的文件移动到指定目录下（晕，第一次使用，怎么不能插入C++代码？）：

1、定义保存系统原来函数的函数SysCreateProcessA：（听起来有点拗口）

static HANDLE (WINAPI* SysCreateFileA)( LPCTSTR lpFileName,       // pointer to name of the file
            DWORD dwDesiredAccess,      // access (read-write) mode
            DWORD dwShareMode,       // share mode
            LPSECURITY_ATTRIBUTES lpSecurityAttributes, // pointer to security attributes
            DWORD dwCreationDisposition,    // how to create
            DWORD dwFlagsAndAttributes,     // file attributes
            HANDLE hTemplateFile      // handle to file with attributes to copy
            ) = CreateFileA;

2、编写自己的功能函数：

HANDLE WINAPI HookCreateFileA( LPCTSTR lpFileName,       // pointer to name of the file
        DWORD dwDesiredAccess,      // access (read-write) mode
        DWORD dwShareMode,       // share mode
        LPSECURITY_ATTRIBUTES lpSecurityAttributes, // pointer to security attributes
        DWORD dwCreationDisposition,    // how to create
        DWORD dwFlagsAndAttributes,     // file attributes
        HANDLE hTemplateFile      // handle to file with attributes to copy
        )
{
char chDestFile[256];

strcpy(chDestFile, lpFileName);
if( strstr(lpFileName, "////.//") != NULL ) // 放过设备
{
  // 创建的普通文件全部转到D盘去，这里没考虑是“读”访问
  char *p = strrchr(lpFileName, &apos;//&apos;);
  if( p++ == NULL )
  {
   p = lpFileName;
  }

  sprintf(chDestFile, "D://%s", p);
}

// 创建文件，注意这里不可以再调用CreateFileA，否则您就递归调用了！取而代之的应该是SysCreateFileA！！！！
return SysCreateFileA(chDestFile, .....); // 后面的参数照搬下来就可以了
}

3、挂钩，用自己的函数替换系统API：

DetourAttach(&(PVOID&)SysCreateFileA, HookCreateFileA);
恢复时用DetourDetach即可。

这下运行您的程序，发现所有用CreateFileA创建的新文件都被转移到D盘下了。