Chapter 20: Creating ActiveX Clients

Generating TLB/REG files

To generate .tlb and .reg files:

Select the package from which the .tlb and .reg files will be generated.
Select File | Generate TLB/REG.
Enter the name of the output directory to store the generated .tlb and .reg files. The default is the root directory of the drive on which EAServer is installed.
In the Proxy Server Location, you must enter the path to the InProcServer corresponding to the Generic ActiveX Proxy DLL (jagproxy.dll).

WARNING! Do not leave this field blank. If you do, an empty string will be inserted into the InProcServer32 entry in the Windows Registry and the ActiveX proxy will not run.
Click the Register box if you plan to run ActiveX EAServer clients on the same machine where EAServer Manager is running. This will register the ActiveX proxy interfaces. The ActiveX proxy interfaces must be registered before applications can use them.

If you do not click the Register box, the .reg file can be manually registered by using the system regedit tool to load it into the machine’s registry. To run ActiveX clients on another machine, copy the generated .reg file to that machine, then use the jagreg tool to load it into the machine’s registry.

After the registry file is registered, do not move the type libraries or the APAS. The registry file maintains absolute paths to these files. If you move any of these files, use the jagreg tool to register the new locations of these files.

The directory containing jagproxy.dll does not need to be in the path. The directory containing EAServer’s C++ client DLLs does need to be in the path.
Click the Save MIDL File box if you want to retain the generated Microsoft interface definition language (MIDL) file. If .tlb/.reg generation fails, the MIDL file may be used to turn the MIDL compiler from the command line to determine the cause of the failure.
Click Generate.

If unsupported constructs or datatypes are present in your file, they are ignored. The generation succeeds and a dialog is displayed. The constructs or datatypes that were not generated to the .tlb/.reg files are displayed in srv.log in the EAServer installation bin directory. For more information about unsupported constructs and datatypes, see Chapter 19, “Creating ActiveX Components”.

View this book as PDF