Registering AQT components to Windows

Normally, when AQT is installed, the components used by AQT are automatically registered to Windows. In some circumstances, this process will fail. When this happens, you will get a message such as:

Component xxx.ocx or one of its dependencies not correctly registered: a file is missing or invalid

This section describes how problems of this nature can be resolved.

Register AQT Components

When you get this error, you will generally be shown the Register AQT Components window. If not, you can open this windows by going Help > Register AQT Components to Windows from the Signon window.

This window shows you all the components used by AQT. For each of these you can:

• click on the Info button to display the current information about the component. This includes the name of the file used and other internal information about the component. This information can be useful to Cardett Associates if they are diagnosing a problem with the component.
• click on Unreg to unregister the component. After you have done this, clicking on Info will should show you that the component is no longer registered.
• click on Register to register the component. After you have done this, clicking on Info should show you that the component is registered.

Information on components is held in two different places in the Windows registry - LOCAL_MACHINE and CURRENT_USER. If you have Admin rights on your PC, the component information will be held in LOCA_MACHINE, if not it will be held in CURRENT_USER.

If you are having trouble with a component, it is recommended that you unregister the component then register it. When you unregister the component it will tidy up any existing entries - sometimes these prevent the register from working successfully.

Registering using regsvr32

An alternate way of registering the components is to use the regsvr32 command. A script is provided with AQT (ocx_register_v8.bat) for registering AQT's components using this command.

• review this script before running it. If you have installed AQT into a directory other than C:\Program Files\Advanced Query Tool, you will need to change the file references to your AQT install directory.
• you may wish to comment out all the regsvr32 statements except the one for the component with which you are having trouble
• we recommend that you uncomment the regsvr32 statement which unregisters the component. Sometimes a component This will provide a "clean" registration of the component.
• you should run this command under a user which has admin rights on your PC. On Windows Vista, you can right-click and select Run as Administrator.

When you run a regsvr32 command, you will get a message such as:

DllRegisterServer in xxxx.ocx succeeded

Errors while running regsvr32

If you are unable to register the component, you will get an error code

• 0x80004005 means that you do not have authority to run this command. You need to log on with a user with admin rights.
• 0x80040200 this error code is not given anywhere in the Microsoft documentation. However it appears to happen when the user doesn't have sufficient authority to run the command.
• other return codes are given at http://support.microsoft.com/kb/249873

When you register a component using the Register AQT Components window, AQT will give you a more meaningful description of the error than you get through regsvr32.