Reviewing HLLAPI traces

The following is the beginning of a BlueZone HLLAPI trace. The return code in this example is 0 (RetCode:0). This means that the HLLAPI application successfully connected to the BlueZone session.
BlueZone v3.4 Build 455 API Trace Started 08/26/2004 at 13:47:47.701
 
Time:  13:47:53.605
Event: WinHLLAPI-In Task:0 Status:0 Func:21 Data:1384668 Len:0 RetCode:0
 
Time:  13:47:53.605
Event: WinHLLAPI-Out Task:0 Status:0 Func:21 Data:1384668 Len:0 RetCode:0

A return code of 1 indicates that the HLLAPI application is not connected to the BlueZone session.

Possible causes of a return code of 1 are:
  • The SetPath=Yes in the setup.ini file is not configured, omitting BlueZone from the computer PATH environment variable.
  • Your computer was not rebooted after changing the SetPath=Yes setting.
  • The BlueZone DDE Server Interface is not enabled.
  • The HLLAPI application is still trying to connect to a competitor's HLLAPI DLL installed on the computer.
  • If your HLLAPI application is looking for a specific HLLAPI DLL name, the correct BlueZone HLLAPI DLL can be renamed with the wrong name.
  • The wrong BlueZone HLLAPI DLL was renamed. Ensure that you renamed the correct DLL, either whllapi.dll (DDE) or whlapi32.dll (shared memory).