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

 PSWSLogin()
------------------------------------------------------------------------------
 Purpose:
 Attaches to and logs a workstation into a print server.

 Syntax:
 iAccess = PSWSLogin( lpszPrintServer )

 Parameters:
 lpszPrintServer The name of the print server.

 Returns:
 A numeric value (signed short int).

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

 Description:
 PSWSLogin() attaches to and logs into a valid print server on the network,
 specified by its name lpszPrintServer.

 If successful, PSWSLogin() returns the user's access level to the print
 server, as follows:

 0  Limited access only.
 1  Access granted as a print server user.
 2  Access granted as a print server operator.

 PSWSLogin() returns NOVERRINT if an error occurs.

 Example:
 // To log in to and display the connection number of print server
 // PRINTERS:
 if( PSWSLogin ( "PRINTERS" ) > 0 )
    ? "You are now logged into print server PRINTERS "
    ??  "Connection Number", PSConnNumberGet()
 endif

 Notes:
 It is only possible to be logged in to one print server at a time.