ChangeTest - sample code to call DinkeyChange.dll in C++ Builder
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

This project is written in C++ Builder 2007 but will work in more recent
versions (they will upgrade the Project to the latest version). For earlier versions
you can make your own project using the files listed below.

The source files in the project are:

File name                Folder                     Description
changetest.c             Samples\c                  main source code file for C
changetest.h             Samples\c                  contains some useful constants
DinkeyChange_borland.lib Samples\c\import_libs      contains the function definitions for DinkeyChange.dll
ChangeTest.rc            Samples\c\C++Builder\DinkeyChange  resource for main dialog 

Note that the source paths are structured to minimise files. If you want to
move this project the references to these files will probably be no longer valid.

The sample code contains 7 functions. Just use which ever functions are most
appropriate and customise in your own way. The sample code is just a guide.
As none of the parameters are sensitive then there is no need to implement
strong security in calling DinkeyChange.

Note - you will not be able to debug your program after DinkeyChange has been called.
Our strong anti-debug code will cause the debugger to throw an exception. However,
if you do need to debug your code you can use our debug module for DinkeyChange:
DinkeyChangeDebug.dll. So, you can use DinkeyChange.dll for your release build
and DinkeyChangeDebug.dll for your debug build.

Note - the DinkeyChange_borland.lib was created using Borland's IMPLIB tool. If there is a problem
with the file we provide you can create your own by running (for example):

c:\program files\CodeGear\Rad Studio 5.0\bin\implib  import_libs\DinkeyChange_borland.lib  DinkeyChange.dll

(This assumes that the current directory is the Samples\C directory).
