Deploying a conduit with the HB++ Conduit installer

Once your conduit is generated, you must register it in the HotSync^® Manager application. This operation can be carried out directly from the IDE using the command "Tools > Conduit Installer".

You should specify the action to carry out from the 4 options, fill out either the Files or Creator field depending on the necessary operation, then click the OK button. If a modification to the HotSync^® Manager is necessary, the HotSync^® Manager is stopped and restarted so that these modifications will take effect.

It is also possible to register a conduit from the command line, using the utility regcond32.exe distributed with HB++. You will find this executable in the HB++ root folder. This utility is redistributable: you can distribute it without restriction, and include it when deploying your projects.

The regcond32 functionality is identical to the "Tool > Conduit Installer" functionality. The syntax of the command line is as follows:

regcond32 [options] [files...]

With no options, the utility copies the collection of specified files into the HotSync^® Manager application folder, and registers the conduit, which must be the first file in the list. This syntax is typically used to install a utility. For example, the following line copies the autograph.dll and readme.txt files into the HotSync^® Manager application directory and registers the autograph.dll :

regcond32 autograph.dll readme.txt

The -c option skips the conduit registration step. This syntax is useful for copying files that are not conduits into the HotSync^® Manager application directory.

The -v option displays the information contained in the conduit. No copies are registered or carried out. For example, the following command displays information about the autograph.dll conduit.

regcond32 -v autograph.dll

The -u option unregisters a conduit from its creator. In this case, no file name should be specified. For example, the following command unregisters all the conduits whose creator is hbAG:

regcond32 -u hbAG

By default, if an error occurs, a message is printed on the console and regcond32 returns a non-null value you can test using the DOS errorlevel statement. If the -g option is specified, errors are reported in a dialog box instead.

Finally, the -h option displays a short help message.