Log a user on to a system
──────────────────────────────────────────────────────────────────────────────

 Syntax

        H_LogOn1( lError )

 Arguments:

      lError - If .T., generate an error when the user fails

 Returns:

      .T. if the user is successful
      .F. otherwise

 Description:

      Prompts the user for a user ID and password from the current H_SEC
      table.  The combination of user ID and password are checked, and
      if correct, .T. is returned.
      The user is given three attempts at entering a combination.  If they
      fail, .F. is returned, and if lError is .T. an error is generated.

      H_Logon1( .F. ) is called by H_SysInit().

 Examples:



 Header File: H_LIB52.CH

 Source: LOGON1.PRG

 Author:  Martin Colloby