home *** CD-ROM | disk | FTP | other *** search
/ Borland Programmer's Resource / Borland_Programmers_Resource_CD_1995.iso / winsock / wlprs40b / wsockaid.asc < prev    next >
Encoding:
Text File  |  1995-05-19  |  4.6 KB  |  113 lines
  1.                    WSOCKAID.DLL Version 2.0a
  2.                                
  3.                       September 29, 1994
  4.                                
  5. This DLL contains functions that are currently missing in the
  6. Windows Sockets 1.1 specification, but which are needed for
  7. some networking applications. Currently this DLL supports only
  8. FTP Software's PC/TCP Version 2.1 and above. For this TCP/IP
  9. stack, all information that WSOCKAID.DLL can give is retrieved
  10. from the PCTCP.INI file (or whatever your PCTCP env. variable
  11. points to). If want to use this DLL together with other stacks
  12. and get errors like "Could not resolve username" from network
  13. applications, look at the list of functions below. For each
  14. inquiry function the information returned to a program can also
  15. be defined in the WIN.INI file by creating a section named
  16. [WSOCKAID] and adding the appropriate entry.
  17.  
  18. For setting the username a Control Panel Applet named
  19. WSAIDCNF.CPL is included. If you move this program to your
  20. WINDOWS/SYSTEM directory, you can set  the username by double-
  21. clicking on the "question mark face" icon. See also the remarks
  22. of the WSAIDGetUsername function below.
  23.  
  24. The following functions are exported by this DLL:
  25.  
  26. WSAIDGetUsername   This function retrieves the user name that
  27.                    a PC user has registered with the
  28.                    networking software. If the used networking
  29.                    software has a real Windows network driver
  30.                    (like PC/TCP 2.2 has) and this driver
  31.                    supports the WNetGetUser function, the
  32.                    return value of this function is given to
  33.                    the calling program instead of the username
  34.                    defined in the [WSOCKAID] section of
  35.                    WIN.INI. You can override this behaviour to
  36.                    always use the username in the [WSOCKAID]
  37.                    section by putting an entry like
  38.  
  39.                           AlwaysUseWSAIDUsername=1
  40.  
  41.                    into this section, or checking the
  42.                    corresponding box in the Control Panel
  43.                    applet.
  44.                    To find out if your networking software has
  45.                    such a driver, look if the [boot] section
  46.                    in SYSTEM.INI contains a network.drv= entry
  47.                    that is not empty.
  48.                    
  49.                    [WSOCKAID]-Entry:  User=<username>
  50.  
  51. WSAIDGetRealname   This function returns the real name that a
  52.                    PC user has registered with the networking
  53.                    software.
  54.                    
  55.                    [WSOCKAID]-Entry:  Full-Name=<user's real
  56.                    name>
  57.  
  58. WSAIDGetHostname   This function returns the locally defined
  59.                    host name for the PC (without any domain
  60.                    information appended).
  61.                    
  62.                    [WSOCKAID]-Entry:  Host-Name=<PC's
  63.                    hostname>
  64.  
  65. WSAIDGetDomain     This function returns the Internet domain
  66.                    that the PC belongs to.
  67.                    
  68.                    [WSOCKAID]-Entry:  Domain=<PC's domain>
  69.  
  70. WSAIDGetDefaultPrinter              This function returns the
  71.                    default LPR network printer as separate
  72.                    queue and server name.
  73.                    
  74.                    [WSOCKAID]-Entry:  LPRQueue=<queue name>
  75.                                    LPRServer=<server name>
  76.  
  77.  
  78. Change Log:
  79.  
  80. Version 2.0a:
  81.  
  82.    WSOCKAID now searches in various other places for a
  83.    username. The search order is:
  84.    1. See if a network driver is installed (see SYSTEM.INI
  85.        section [boot], entry network.drv=). If present, call
  86.        its function WNetGetUser().
  87.    2. Look if the env. variable PCTCP is defined. If so, try
  88.        to read the username from the relevant INI file.
  89.    3. Look if the SYSTEM.INI section [Network] contains an
  90.        entry Username=.
  91.    4. Look if a file TCPUTILS.INI exists which has an entry
  92.        Username= in the section [TCPGlobal]
  93.    5. Return an error value.
  94.  
  95. Copyright:
  96.  
  97. This DLL is Copyright (C) 1993-94 by Thomas Heil.
  98. Redistribution of this DLL is allowed only together with the
  99. documentation (as PostScript file and as plain ASCII .ASC
  100. file). This software may not be sold by itself. Applications
  101. that use this DLL may be sold together with the DLL and its
  102. documentation included royalty free.
  103.  
  104. If you are a network software vendor and think that your TCP/IP
  105. stack should be supported, please contact me.
  106.  
  107. Author:
  108.  
  109. Thomas Heil
  110. Hindenburgstr. 50
  111. 41352 Korschenbroich
  112. E-Mail: th.heil@kfa-juelich.de (Internet)
  113.