			FINGER.VBX

This VBX implements the "FINGER" protocol. It assumes the presence of a 
WINSOCK compliant DLL. 


This VBX is shareware. To register on compuserve
go SWREG and search by userid 71507,1033. To register by mail send $10
made payable to Steve Bridges To:

Steve Bridges
76 Nash St
New Haven CT 06511

registered users recieve the latest version plus the code.

The rest of this document describes the properties & Events of the VBX. There
is also a demo (VBFINGER.MAK) enclosed with this ZipFile.

If you have any questions you can contact me on compuserve at 71507,1033


			PROPERTIES

Host
 A string representing the IP address of the finger Daemon. This can be in the
 form of a dotted IP Address of a name that the VBX will attempt to resolve
 using a DNS call.
 Example.

	finger1.Host = "3.45.345.32"
	finger1.Host = "The.Remote.Host"


User
 A string designating the User on the remote host that you want to finger.
 Leaving this blank typically returns a list of all users on the remote system.

            
Verbose
 An integer with two settings

    0 - Instructs the Daemon to return the 'normal' output 
    1 - Instructs the Daemon to return more verbose output. (If available)

                          
Action

	Set this property to 0 to carry out the finger using the above
        properties.


DebugMode

	Set this property to true to have the .VBX send OutputDebugString
        calls at various points during it's execution. Note. This feature 
        requires an application that can trap and display the debug strings.
        Don't set this unless you have such an application. It can cause the
        machine to run very slowly otherwise.
                                    


                                        EVENTS.


Response.

NoMore    Integer
Msg       String.

This event is triggered for each line of text returned by the Finger Daemon.
The Msg string will hold the line with the Carriage Return Line Feed combination
stripped off.
When the last line has been sent the event will be fired again with NoMore
set to true and Msg set to the last piece of data returned by the Finger Daemon.

AsynError


ErrCode    Integer

This event will be fired if the control receives an unexpected error while
processing an asynchronous request. The value of ErrCode will be the error
number returned by your WINSOCK.DLL



                             RUN TIME ERRORS

The control will generate the following run time errors :

20000 : Invalid Action. The Action property was set to other than a 0
20009 : Missing Host. This VBX requires the TCP\IP address of the host that
        is running the Finger Daemon.
20006 : Call in process. An outstanding asynchronous call is in progress.
        This VBX make most of it's call to WINSOCK using WINSOCKs ASYNC mode
        of operation. This error will be returned if you try to make a new
        call while one is still outstanding.

