Click above to get retro games delivered to your door ever month!

 FSWSLogin()
------------------------------------------------------------------------------
 Purpose:
 Log a user into the file server.

 Syntax:
 bResult = FSWSLogin( lpszUserName, lpszPassword, wObjectType )

 Parameters:
 LpszUserName The user's login name.
 LpszPassword The user's password.
 WObjectType  The object type.

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper name for this function is:
 FSWSLogin()

 Description:
 FSWSLogin() returns TRUE if the user specified by lpszUserName with
 password lpszPassword is logged into the default file server.

 Returns FALSE if not, or if an error occurs. In all cases the current
 workstation user (if any) is logged out before attempting to log in the new
 user. The parameter wObjectType can be used to log in users of an unusual
 object type. It is not advisable to use this option unless you are very
 familiar with the NetWare operating system.

 Example:
 // To log a user DAVE with password DAVESPASS into the default file server:
 if ( FSWSLogin("DAVE","DAVESPASS",OT_USER) )
    ? "User DAVE is now logged in"
 endif

 Notes:
 If a user who is already logged into a file server(s) tries to log
 into another file server with an incorrect password, that user will
 immediately be logged out of ALL the file servers. FSWSLogin() does not run
 the login scripts.

 If FALSE is returned, check NWErrorGet(). Under NetWare 2.x & 3.x the name
 and password MUST be in capital letters. Check NWErrorGet() after calling
 FSWSLogin() to see if it is set to 223, which means the login has been
 allowed, but the password has expired and one of the grace logins has been
 used up.

 CA-Clipper only - if the wObjectType parameter is omitted, NOVLIB will
 login the object as a USER