Installation
Installing the SRP ActiveX Controls is a two step process. It's important to know these steps as you will have to repeat (or automate) them when you distribute your application.
- Copy SRPControls.ocx onto your local machine
- Register it.
Copying
The first step is to copy SRPControls.ocx onto the target machine. You can place it anywhere you wish, but we recommend placing it in a dedicated folder (such as "SRP") or in Revelation's client folder (typically C:\Revsoft\OIClient). It's okay to place it inside the OI root folder only if the application is not used by more than one user at a time. Avoid placing the OCX into a shared folder as doing so makes it difficult to update due to shared locking. Since you have to register the OCX on individual machines anyway, you might as well copy it locally. This will increase performance and decrease locking issues.
Registration
In order for your application to utilize our controls, Windows needs to know where to find the SRPControls.ocx. This is done through registration. When you register an OCX file, entries are placed in the registry detailing the OCX file's location, the types of controls within the OCX, and more. This information allows your application, as well as any other applications, to quickly gain access to the SRP ActiveX Controls.
To register an OCX file, simply run the following command from a DOS prompt or from the Run window:
regsvr32 <ocxfile>
The regsvr32 command is built into Windows. It's sole purpose is to register and unregister self-registering DLLs. OCX files are considered self-registering DLLs, even though their extensions are different. To register:
regsvr32 "C:\Revsoft\OICLient\SRPControls.ocx"
64-Bit
Registering the 64-bit version of our controls uses the same command line. RegSvr32 is clever enough to register either 32-bit or 64-bit. Since our 64-bit version has a different file name (SRPControls64.ocx), you can register both to the same machine without conflict.64-Bit
Updating
We update our controls on a frequent basis to ensure you always have the most complete and robust controls available. To update your controls, simply replace SRPControls.ocx with the new file and register it. In many cases, failing to re-register the new OCX may not cause you any harm. But if the new OCX has new properties, methods, or events, you may find that those new elements are inaccessible. To be safe, always register a new OCX. You do not need to unregister the old OCX before registering the new one.
Uninstalling
To uninstall the SRP ActiveX Controls, you first need to unregister SRPControls.ocx. You can use the regsvr32 command. The syntax for unregistering your files is:
regsvr32 -u "C:\Revsoft\OICLient\SRPControls.ocx"
SRPUtil.ocx
Some of our tools, such as the SRP Editor, use the SRP ActiveX Controls. In order to avoid clobbering your version of SRPControls.ocx, out tools use SRPUtil.ocx. Normally, you will never have to deal with this file as the SRP Editor installer (and any other installer using SRPUtil) will copy and register this OCX for you. However, it's useful to know what this file is and why it exists.
