FN_LOGINFS()
 LoginToFileServer
------------------------------------------------------------------------------
 Syntax
 
       fn_loginFS( <cName> [, nType ] [, <cPassword> ] ) -> lSuccess
 
 Arguments

      <cName> is the name of the object to login.  It can be from 1 to 47
      characters in length.

      <nType> is an optional object type.  For a list of Netware Object
      types, refer to NETTO.CH, or the "Information" section of this
      Norton Guide.  If omitted, <nType> defaults to OT_USER.

      <cPassword> is an optional password, up to 127 characters.  If a
      password is not supplied but required, the system will prompt for
      one.

 Returns

      A logical indicating whether the object was successfully logged in.

 Description

      This function attempts to log in to the default file server.  If
      successful, the server places the Bindery object's ID in the server's
      Password Table in the same location as the object occupies in the
      server's Connection ID table.

      For example, if the workstation occupies postition 97 in the File
      Server Connection Table, then the Bindery object's ID number is
      placed in the 97th position in the Password Table.  Therefore, if
      a Bindery object logs into a specific server from three workstations,
      its Binery object ID number is placed in the Password Table three
      times, in the positions reserved for each workstation.

      NOTE!  This function does _not_ support encrypted passwords.
      Due to licensing restrictions from Novell, we could not include
      encrypted support in this public domain release.  However, it
      is available.  See elsewhere in the Norton Guide for details
      on password encryption support.

      NOTE:  THIS FUNCTION DOES NOT EMULATE THE NETWARE LOGIN COMMAND!
      It does not run the login script, nor does it map any drives!
      It simply logs you in.

 Examples

      IF !fn_attchFS( "SALES" )          // attach to server
         <... unable to attach ...>
      ELSE

         aFSNameTable := fn_FSName()     // get list of attached servers
                                         //  to find ConnectionID

         nConnID := ASCAN( aFSNameTable, {|e| e == "SALES" })

         fn_SPFCID( nConnID )            // set preferred server
                                         //  and log in to it

         fn_loginFS( "SLARSEN", OT_USER, "dork" )

      ENDIF


 Source: N:\SRC\CONNWS\LOGIN.PRG

 Author: Steve Larsen