Zapcode

 

Example Name:                              ZapCS

 

Language:                                       C

 

API type:                                           Shared Library

 

API component filename:            McClient.dll

 

Environment:                                  Windows 2000, XP, Vista (Using Visual Studio 2005)

 

 

What does it do?

 

Demonstrates the use of, communicating with the Capscan Pool Manager and searching.

 

 

Could be used as a starting point for:

 

Creating an application to capture or verify an address using a postcode.   

 

 

Where to find the example code:

 

After running the setup from the Zapcode CD to install the client APIs you will find these examples installed (by default) in:

 

C:\Program Files\Capscan\SDK\Zapcode Client API\DLL\Examples\c

 

If you have installed to another location you will need to change the path where necessary.

 

 

What each file does:

 

File name                                         What does it do?

 

ZapCS.c                                                The source for searching and displaying the results.

 

ZcClient.h                                             Client API header file.

 

McClient.h                                            Client API header file.

 

ZcdClient,sln                                        Visual Studio 2005 solution file.

 

Spider.ini                                              Capscan Client/Server configuration file.

 

 

Preparing to run the example:

 

Please make sure that you have installed the Capscan Pool Manager and that it is up and running.

 

 

 

Running the example:

 

1.       Make sure that the API library is in the search path.

 

2.       Open the ZcdClient.sln solution file.

 

3.       Make sure that the correct host name is set in the local spider.ini file. 

 

        If you are not using the spider.ini file make sure that the correct host name is passed to         the McSetParam() function.

 

4.       Save your changes.

 

5.       Make sure that the Solution Configuration is set to Debug.

 

6.       Press F5 to run the example.

 

7.       Follow the on screen prompts to select the required pool and search requests.

 

 

Trouble-shooting and hints:

 

1.       If you are running on a LAN make sure that the Capscan Pool Manager is running correctly.  To do this you can use the PoolMan Admin application that is installed along with the Capscan Pool Manager.

 

2.       If you are using a firewall make sure that it is not blocking this example or the Capscan Pool Manager.  By default the Capscan Client/Server uses port 27920 for sending and receiving data.

 

3.       Try installing and running the Zapcode application to test that the Capscan Pool Manger is working correctly.  The installation for Zapcode can be found on the CD under:

 

                Api\zcd_cs\win32\client\zapcode

 

4.       For more hints and tips please see the SDK bookshelf documentation.