Installation

To install on a test or developer system, use the install.exe program provided with the distribution. This installs the core DLL(s) in your main windows system directory and creates copies of all other required files, including this manual, in the directory C:\Program Files\CryptoSys (32-bit platforms) or C:\Program Files (x86)\CryptoSys (64-bit platforms).

To distribute a Licensed Version to your end users, please read the instructions in the file distrib.txt. You do not use the install.exe program to distribute to end users. Note that the core DLL file is completely different for the Trial and Developer versions. All other files are the same.

Important: You must use the install.exe program to install the Trial version on your system and you must have administrator rights when installing or uninstalling this version.

To uninstall, use Start > Settings > Control Panel > {Programs and Features}|{Add/Remove Programs} > CryptoSys API to remove the application and all associated files.

Core executable DLL

The core executable is diCryptoSys.dll which is a native Windows DLL. This file must exist in the library search path on the user's system for all programming language interfaces. The executable diCryptoSys.dll is not registered with RegSvr32 (it can't be). The VB6/VBA and C/C++ interfaces access this core executable directly.

Wrapper DLLs

Two wrapper executables are provided to allow .NET and COM programming access to the core executable. Both require the core native diCryptoSys.dll to exist in the library search path.

1. diCrSysAPINet.dll is a .NET Class Library which exposes various classes to allow programming access from C# and VB.NET projects. This file is referenced from your .NET project. It is not registered. It is installed by default in C:\Program Files (x86)\CryptoSys\DotNet\ and is compiled for all platforms (Win32 and X64). You will need to set a reference to it from your .NET projects.
2. diCryptOCX.dll is a 32-bit ActiveX DLL which exposes various classes to allow programming access from ASP, VBScript and other 32-bit COM applications including VB6. Note it is not supported by 64-bit Microsoft Office. The installation program [as of v4.4] now registers this automatically during installation. This file is installed by default in C:\Program Files\CryptoSys\COM or C:\Program Files (x86)\CryptoSys\COM on a 64-bit machine.

   If you are distributing to end users you need to ensure this DLL is registered. It does not self-register. To register manually, copy the diCryptOCX.dll to a convenient folder on the target machine, open a command prompt 'as administrator', and type

      REGSVR32 myfolder\diCryptOCX.dll
   

   You must have administrative privileges. With NSIS, use the RegDLL instruction but make sure the core diCryptoSys.dll is installed first. For more information on installation and possible errors, please read the file ActiveXreadme.txt in the COM folder of the distribution.

For more information on the executables, see Technical Details.