Click here to Skip to main content
15,390,470 members
Articles / Programming Languages / C++
Posted 27 Nov 2006


105 bookmarked

Create your Proxy DLLs automatically

Rate me:
Please Sign up or sign in to vote.
4.91/5 (49 votes)
14 May 20072 min read
Here is a small program that will create the CPP and DEF for a proxy DLL, based on the exports of another DLL. You can use it to generate a template and then you edit this template to satisfy your needs.


A lot of us have tried to create a proxy DLL to replace an existing one and spy other programs' calls. Here is a small program that will create the CPP and DEF for a proxy DLL based on the exports of another DLL. You can use it to generate a template and then edit this template to satisfy your needs.


When creating a proxy DLL, you have to export precisely the same names as exported by the original DLL. This can be painful, for two reasons:

  1. There are too many exports.
  2. There are functions that you don't know what they do; you'd just want to spy on one specific function call.

The second problem is solved with assembly and with the aid of the __declspec(naked) attribute. The program creates function stubs that do nothing but JUMP (not call) to the exported address, so the stack is left as it should be. This allows you to create code only for functions that you actually know what they do.

Using the program

WRAPPIT <dll> <txt> <convention> <point dll name> <cpp> <def>  
  • <dll> is the new DLL name you want to create. The program can compile the DLL using VC++ or BC++, depending on how you comment or edit lines 233-237:
    // _stprintf(ay,_T("BCC32 -o%s.obj -c %s\r\n"),argv[5],argv[5]);
    _stprintf(ay,_T("CL.EXE /O2 /GL /I \".\" /D \"WIN32\" /D \"NDEBUG\" /D" 
              "\"_WINDOWS\" /D \"_WINDLL\" /FD /EHsc /MT /Fo\".\\%s.obj\" " 
              "/Fd\".\\vc80.pdb\" /W3 /nologo /c /Wp64 /TP " 
              "/errorReport:prompt %s\r\n"),argv[5],argv[5]);
    // _stprintf(ay,_T("ILINK32 -c -Tpd %s.obj,
    //           %s,,,%s\r\n"),argv[5],argv[1],argv[6]);
    _stprintf(ay,_T("LINK.EXE /OUT:\"%s\" /INCREMENTAL:NO /NOLOGO /DLL" 
              " /MANIFEST /DEF:\"%s\" /SUBSYSTEM:WINDOWS /OPT:REF " 
              "%s.obj kernel32.lib user32.lib gdi32.lib winspool.lib " 
              "comdlg32.lib advapi32.lib shell32.lib ole32.lib " 
              "oleaut32.lib uuid.lib odbc32.lib odbccp32.lib\r\n"), 
  • <txt> is a text file containing the exports from the original DLL. You can create this file with either dumpbin:
    dumpbin /exports original.dll > exports.txt

    or with tdump:

    tdump original.dll -ee > exports.txt
  • <convention> is the convention call you want your functions to have. You will usually want to use __stdcall, but it hardly matters what you use because the stub functions immediately jump to the existing code and therefore, they should work with any calling convention.
  • <point dll name> is the DLL name that your proxy DLL will try to load. Make sure you use C++ escape characters like \\.
  • <cpp> is the generated CPP file.
  • <def> is the generated DEF file.


You have WSOCK32.DLL and you want to create a proxy for it, replacing the original DLL as WSOCK32_.DLL. What would you do?

  • move wsock32.dll wsock32_.dll
  • dumpbin /exports wsock32_.dll > exports.txt
  • wrappit wsock32.dll exports.txt __stdcall .\\wsock32_.dll wsock32.cpp wsock32.def

This will:

  • Parse the text file for exports and create the DEF. Exported functions by ordinal only are supported.
  • Create the sample CPP code. In the DLL's code DllMain, the original wsock32_dll will be loaded with LoadLibrary(). Then all the original exported functions' addresses will be returned by GetProcAddress and stored in an internal pointer. Then stubs for each function will be created.

A single CPP will look like this:

#include <windows.h>
#pragma pack(1)
FARPROC p[75] = {0};
// -----------
    if (reason == DLL_PROCESS_ATTACH)
        hLThis = hInst;
        hL = LoadLibrary(".\\wsock32_.dll");
        if (!hL) return false;

        p[0] = GetProcAddress(hL,"AcceptEx");
        p[1] = GetProcAddress(hL,"EnumProtocolsA");
        p[2] = GetProcAddress(hL,"EnumProtocolsW");
    if (reason == DLL_PROCESS_DETACH)
    return 1;

// AcceptEx
extern "C" __declspec(naked) void __stdcall __E__0__()
        jmp p[0*4];

// EnumProtocolsA
extern "C" __declspec(naked) void __stdcall __E__1__()
        jmp p[1*4];

// EnumProtocolsW
extern "C" __declspec(naked) void __stdcall __E__2__()
        jmp p[2*4];

A single DEF will look like this:

AcceptEx=__E__0__ @1141
EnumProtocolsA=__E__1__ @1111
EnumProtocolsW=__E__2__ @1112

You may now edit CPP/DEF files and reuse them to create your own proxy DLL!


Once the cpp is ready, you should replace functions that you know how to use. For example, If you want to spy on Wsock32.send():

// send, created by wrappit
extern "C" __declspec(naked) void __stdcall __E__69__()
    jmp p[69*4];

// If you want to manipulate it, change to:
extern "C" int __stdcall __E__69__(SOCKET x,char* b,int l,int pr)
  // manipulate here parameters

  // call original send
     typedef int (__stdcall *pS)(SOCKET,char*,int,int);
     pS pps = (pS)p[63*4];
     int rv = pps(x,b,l,pr);

     return rv;


  • 14 May, 2007 - Fixed problem occuring when dumpbin.exe generates RVA information as well


This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


About the Author

Michael Chourdakis
Software Developer
Greece Greece
I'm working in C++, PHP , Java, Windows, iOS, Android and Web (HTML/Javascript/CSS).

I 've a PhD in Digital Signal Processing and Artificial Intelligence and I specialize in Pro Audio and AI applications.

My home page:

Comments and Discussions

QuestionQuery in pS pps = (pS)p[63*4] Pin
Member 1480445516-Apr-20 21:20
MemberMember 1480445516-Apr-20 21:20 
AnswerRe: Query in pS pps = (pS)p[63*4] Pin
chenzero1-Oct-20 17:26
Memberchenzero1-Oct-20 17:26 
Questionerror generating cpp file Pin
Member 1480445516-Apr-20 15:33
MemberMember 1480445516-Apr-20 15:33 
AnswerRe: error generating cpp file Pin
Member 1480445516-Apr-20 21:17
MemberMember 1480445516-Apr-20 21:17 
QuestionI get a BadImageFormatException exception, then the exe dies. Pin
Member 128371477-Nov-16 7:35
MemberMember 128371477-Nov-16 7:35 
Praisethx Pin
neo85x23-Jun-16 12:53
Memberneo85x23-Jun-16 12:53 
QuestionUnable to call any original methods Pin 4:12 4:12 
BugCalling LoadLibrary in DllMain? Pin
ddbug2-Jun-15 11:31
Memberddbug2-Jun-15 11:31 
GeneralRe: Calling LoadLibrary in DllMain? Pin
SAiBOTiERT6-Jun-17 11:34
MemberSAiBOTiERT6-Jun-17 11:34 
GeneralRe: Calling LoadLibrary in DllMain? Pin
Graeme Gill11-Sep-20 21:38
MemberGraeme Gill11-Sep-20 21:38 
Questionmangled named containing @ Pin
ernest_hemingway0777-May-14 5:16
professionalernest_hemingway0777-May-14 5:16 
AnswerRe: mangled named containing @ Pin
afterwhoru8-May-14 3:22
Memberafterwhoru8-May-14 3:22 
GeneralRe: mangled named containing @ Pin
Omega Doe5-Mar-15 5:34
MemberOmega Doe5-Mar-15 5:34 
AnswerRe: mangled named containing @ Pin
Graeme Gill18-Nov-15 13:25
MemberGraeme Gill18-Nov-15 13:25 
QuestionD3D9.DLL - Direct3DCreate9 no return(?) Pin
Tom Burbeck14-Jan-14 12:56
MemberTom Burbeck14-Jan-14 12:56 
AnswerRe: D3D9.DLL - Direct3DCreate9 no return(?) Pin
Tom Burbeck14-Jan-14 14:08
MemberTom Burbeck14-Jan-14 14:08 
QuestionCan anyone upload wrappit2? Pin
Lowlife123421-Aug-13 8:03
MemberLowlife123421-Aug-13 8:03 
AnswerRe: Can anyone upload wrappit2? Pin
Michael Chourdakis21-Aug-13 22:56
mvaMichael Chourdakis21-Aug-13 22:56 
Questionare there mistakes in the example usage? Pin
yoels1-Jun-12 20:40
Memberyoels1-Jun-12 20:40 
AnswerRe: are there mistakes in the example usage? Pin
Michael Chourdakis1-Jun-12 22:52
mvaMichael Chourdakis1-Jun-12 22:52 
QuestionAccess violation error Pin
nksung5-Dec-11 20:04
Membernksung5-Dec-11 20:04 
Questionwrappit2 generates 2 def files Pin
kevincw0120-Oct-11 10:18
Memberkevincw0120-Oct-11 10:18 
AnswerRe: wrappit2 generates 2 def files Pin
Michael Chourdakis21-Oct-11 5:34
mvaMichael Chourdakis21-Oct-11 5:34 
GeneralMy vote of 5 Pin
Ashley Davis25-Sep-11 18:15
MemberAshley Davis25-Sep-11 18:15 
GeneralNice work Pin
Zeko7829-Mar-11 0:33
MemberZeko7829-Mar-11 0:33 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.