ComSpy95 & ComSpy3x

 

Introduction

Technical Support

HELP

System-Wide Hook

Trouble Shooting

Product & Order 

www.spywindows.com

 

INTRODUCTION

 ComSpy3x for Windows 3.x is designed to capture Windows COM API calls and their parameters. It traps the API called, logs the parameters, displays the log on the screen, saves log to file, copy log to clipboard, and also save the commands/data sent/received through your modem to the log files.

ComSpy95 for Windows 95 is designed to capture Windows COM API calls, WINSOCK API calls, and their parameters. It is able to trap both 32bit calls and 16bits calls at the same time. It also logs the parameters, displays the log on the screen, saves log to file, copy log to clipboard, and also save the commands/data sent/received through your modem to the log files.

Both ComSpy3x and ComSpy95 share the same look & feel user interface that has caption, menu, tool bar with tool buttons, display area, and status bar. The printed reports also share the same format.

 

HELP

H.1 Getting Start

H.2 Configuration

H.3 Log Screen

H.4 Log Files

H.5 Button Controls

 

 H.1 Getting Start

After you install the program, you should restart the Windows, this enables that Windows loads the new drivers.

If it is the first time you run ComSpy95/ComSpy3x, you did not setup registration before, you are running the try & buy edition, or you click 'Reload Registration' menu, you will see this dialogbox:

 

Enter the drive letter in the entry field (default to 'A') to tell ComSpy3x/ComSpy95 where to load your identification file. If you are running try & buy edition, simply click on <Cancel> to continue to try the program. If you like the program, you may register the program online through CompuServe or you may contact the resellers (for example, ZAC Catalog) to order the product. If you register the program on line, you will receive your identification file (COM3XUR.DAT for ComSpy3x or COM95UR.DAT for ComSpy95) shortly. Run the program, click on "Reload Registration" menu to load the identification file to enable all features that ComSpy3x/ComSpy95 provides. If you purchase ComSpy3x/ComSpy95 from the resellers, please complete the registration to receive your personalized identification file.

If you see one of the following dialogboxes, you are running the trial edition or the unregistered copy or ComSpy95/ComSpy3x can not locate your identification file, COM95UR.DAT for ComSpy95 and COM3XUR.DAT for ComSpy3x, or the identification file is corrupted. Please do not modification the identification file or you will corrupt the file and ComSpy95/ComSpy3x will consider that you are an unregistered user and disable some important features. If you accidentally delete the file, you can copy the file, COM95UR.DAT or COM3XUR.DAT, from the shipping disk to the directory where ComSpy95/ComSpy3x is installed.

If you see this dialogbox, you are running the trial edition. By clicking on OK, you can continue to start the program. Since this is a limited edition, some hooks are disabled and some featured are disabled also. Do not modify or delete the identification file. If you do so, ComSpy95/ComSpy3x will consider you are not a registered user, prompt you this dialogbox, and disable many useful features.

If you purchase ComSpy95 or ComSpy3x from the resellers, you will see this dialogbox every time you run the program until you complete the registration and load your personalized identification file.

Write down the serial number shown in the dialogbox, C95-4000001-PRU in this example. Within the package you received, there is a registration form. Please complete and send/fax back the form. Please do fill in your email address. You will receive a new identification file, COM95UR.DAT/COM3XUR.DAT, via email shortly after we verify the serial number and record your registration. When you receive the final identification file, simply replace the one on your system with it. Once you complete the registration, you should not see this message anymore.

Keep the identification file in a safe place. You need it when you reinstall the program. If you do not complete the registration, the program will expire after a period of time.

Please be aware that each shipped copy does possess a unique serial number that can be traced back its distributor.

If there is a conflict, for example, the serial number already registered by someone else, we will need to ask you provide us with the proof of purchase (the invoice you received from whom you purchase the program from).

 H.2 Configuration

  1. Enable/disable hook(s)
  2. If you are running the shipped version or the registered version, you can enable the hooks on the APIs you are interested in and disable all other hooks. Use left mouse button to turn on or turn off the hook. When you exit the program, the setting will be stored in \WIN95\ComSpy95.INI or \WIN31\ComSpy3x.INI.

    If you are running the trial edition, you will not be able to operate on this screen and the spy randomly enable/disable the hooks when you start the program. When you try to click on right mouse button, ComSpy95/ComSpy3x will prompt a message saying that this feature is disabled.

  3. Font
  4. A font selection dialogbox is provided that you can change the font used to display the log on the screen and the report. By default, the spy uses Arial, 7point font.

  5. Printer setting
  6. A standard printer setup dialogbox is available that you can select the desired printer and setup its settings.

     H.3 Log Screen

    Log screen has two modes which are controlled by the horizontal scroll bar. For the first mode, you may see a log screen like this:

    (Captured with WINCOM running and connecting to CompuServe)

    (Captured with Microsoft Internet Explore running and visiting www.spywindows.com)

    It displays these fields:

    OS: it indicates if the call is a 16bit call or a 32bit call.

    RESULT: it shows the return value of the API called.

    FUNCTION CALLED: it shows the name of the API called

    CALLER: it tells you the name and the ID of the process/task that issues the call.

    PARAMETERS: It lists the parameters passed in the call.

    If you click and set horizontal scroll bar to 1, you will see this log screen:

    (Captured with WINCOM running and connecting to CompuServe)

    (Captured with Microsoft Internet Explore running and visiting www.spywindows.com)

    The first four fields are the same. The last one displays the extended information of the parameters. For example, if the parameter is string type, it shows its contents (it shows only the first 40bytes).

     H.4 Log Files

     Two types of log files are provided.

    1. LOG file for API calls
    2. You can click on 'Save' to save the log (displayed in log screen) to file. ComSpy95/ComSpy3x will display standard Windows 'SaveAs' dialog:

      Select target directory, enter log filename, and click 'Save' button to save the log to file.

    3. LOG files for command/data sent/received

You can capture command sent and data received via your modem to data files also. To do so, simply click on the 'capture' button to start the logging. By default, it saves received data to 'C:\rcom95.cap' or 'C:\rcom3x.cap' and saves commands/data sent to 'C:\wcom95.cap' or 'C:\wcom3x.cap'. You can use this dialogbox to change the command/data log files:

It is recommended that you should specify the full path. This is due to that when ComSpy95/ComSpy3x writes the log, the relative path will be relative to the current directory of the process/task monitored.

 H.5 Button Controls

We have adapted and implemented the new style button controls in ComSpy95/ComSpy3x. When you move cursor over the button control, it shows the button border to indicate the focus.

The 'capture' button is a two-state button control. In push-in state, it indicates that 'capture' is enabled.

 

TROUBLE SHOOTING

ComSpy95/ComSpy3x does check the version of FuncHook installed on your system and prompt you the error message if the desired version is not present or the files are not located in the designated path.

 ERROR 1001

The spy fails to create the sharable heap(s). This may happen when Windows is unable to allocate memory.

ERROR 1011

The spy is unable to allocate memory. It is recommended that you click 'Clear' button periodically to clear the log to release memory for future use. You can do one of these, add more RAM or set swap file to a disk partition with larger free space, to improve it.

If you are running the prior version of ComSpy95, you may encounter this error message if you did not follow the README file to copy FHK95.DLL, FHK16.DLL, and SMIDGEON.VXD to \WIN95\SYSTEM directory. This is due to that ComSpy95 needs to expand the heap but unable to locate the driver. If you are running the lastest version, ComSpy95 does check the existence of the files and prompt error message if it is unable to locate any of them under \WIN95\SYSTEM directory and terminates.

ERROR 1101

The spy fails to starts. Both ComSpy3x and ComSpy95 are designed to run single instance only. If you try to start the second instance of the spy, you will receive this error and may cause GPF.

ERROR 1102

The spy checks the result when registering its private window class and prompts this error if RegisterClass fails.

ERROR 1103

 The spy checks the result when creating main window and prompts this error if CreateWindow or CreateWindowEx fails.

 

TECHNICAL SUPPORT

 If you encounter any problem or discover any bug, please report to us via

    1. Email
    2. You can email your report or question to one of these two addresses:

      71670.176@compuserve.com or info@spywindows.com

    3. Fax

(847) 969 1512

The order hotline is provided mainly for taking order. Though your report or question will be forwarded to technical staffs, it may be delayed.

 

SYSTEM-WIDE HOOK

FuncHook enables programmers to setup SYSTEM-WIDE hooks to monitor 32bit APIs or 16bit APIs on Windows 3.x (the 16bit version of Microsoft Windows) or Windows 95. Based on this advanced technology, we have developed several SPYs and MONITORs that focus on different needs. For example, ExeSpy95/ExeSpy3x that monitors program execution, ResSpy that monitors resource access, ComSpy95/ComSpy3x that monitors COM/WinSock activities, MemMonitor95 STD/PRO that keeps track on memory usage and possibly help to detect memory leaking, ODBCSpy95 that let you monitor all ODBC drivers at the same time, SetupMonitor95 that keeps an eye on what installer has done to your system, etc.. You can download the trial version of all SPYs or MONITORs from www.spywindows.com.

With FuncHook SDK, you can write your own spy or monitor that monitor Windows native APIs or APIs in third party DLLs. You can find the sample that demonstrates monitoring the CreateProcess and TerminateProcess calls, on www.spywindows.com.

 

PRODUCT AND ORDER

There are other SPYs and MONITORs available. Please visit www.spywindows.com for up-to-date information and order information.

You may directly order from us or order from the resellers. Contact info@spywindows.com for reseller information.