WSOCKAID.DLL Version 2.0
                               
                        March 16, 1994
                               
This DLL contains functions that are currently missing in the
Windows Sockets 1.1 specification, but which are needed for
some networking applications. Currently this DLL supports only
FTP Software's PC/TCP Version 2.1 and above. For this TCP/IP
stack, all information that WSOCKAID.DLL can give is retrieved
from the PCTCP.INI file (or whatever your PCTCP env. variable
points to). If want to use this DLL together with other stacks
and get errors like "Could not resolve username" from network
applications, look at the list of functions below. For each
inquiry function the information returned to a program can also
be defined in the WIN.INI file by creating a section named
[WSOCKAID] and adding the appropriate entry.

For setting the username a Control Panel Applet named
WSAIDCNF.CPL is included. If you move this program to your
WINDOWS/SYSTEM directory, you can set  the username by double-
clicking on the "question mark face" icon. See also the remarks
of the WSAIDGetUsername function below.

The following functions are exported by this DLL:

WSAIDGetUsername                    This function retrieves the
                   user name that a PC user has registered
                   with the networking software. If the used
                   networking software has a real Windows
                   network driver (like PC/TCP 2.2 has) and
                   this driver supports the WNetGetUser
                   function, the return value of this function
                   is given to the calling program instead of
                   the username defined in the [WSOCKAID]
                   section of WIN.INI. You can override this
                   behaviour to always use the username in the
                   [WSOCKAID] section by putting an entry like

                             AlwaysUseWSAIDUsername=1

                           into this section, or checking the
                   corresponding box in the Control Panel
                   applet.
                                    To find out if your
                   networking software has such a driver, look
                   if the [boot] section in SYSTEM.INI
                   contains a network.drv= entry that is not
                   empty.
                   
                   [WSOCKAID]-Entry:  User=<username>

WSAIDGetRealname                    This function returns the
                   real name that a PC user has registered
                   with the networking software.
                   
                   [WSOCKAID]-Entry:  Full-Name=<user's real
                   name>

WSAIDGetHostname                    This function returns the
                   locally defined host name for the PC
                   (without any domain information appended).
                   
                   [WSOCKAID]-Entry:  Host-Name=<PC's
                   hostname>

WSAIDGetDomain                      This function returns the
                   Internet domain that the PC belongs to.
                   
                   [WSOCKAID]-Entry:  Domain=<PC's domain>

WSAIDGetDefaultPrinter              This function returns the
                   default LPR network printer as separate
                   queue and server name.
                   
                   [WSOCKAID]-Entry:  LPRQueue=<queue name>
                                   LPRServer=<server name>


Copyright:

This DLL is Copyright (C) 1993-94 by Thomas Heil.
Redistribution of this DLL is allowed only together with the
documentation (as MS Word for Windows 2.0 .DOC file and as
plain ASCII .ASC file). This software may not be sold by
itself. Applications that use this DLL may be sold together
with the DLL and its documentation included royalty free.

If you are a network software vendor and think that your TCP/IP
stack should be supported, please contact me.

Author:

Thomas Heil
Hindenburgstr. 50
41352 Korschenbroich
E-Mail: th.heil@kfa-juelich.de (Internet)