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

 UsrConLst()
------------------------------------------------------------------------------
 Purpose:
 List a user's connection number(s).

 Syntax:
 iConnNum = UsrConLst( lpszUserName )

 Parameters:
 lpszUserName The login name of the user.

 Returns:
 A numeric value (signed short int).

 Description:
 UsrConLst() is initially called with lpszUserName containing the login
 name of the user to be checked and returns the number of connections
 where that user is currently logged in. Subsequent repeated calls with
 lpszUserName specified as a NULL string ("") return the connection
 numbers where the specified user is logged in.

 Returns NOVERRINT when there are no further connection numbers to recall,
 or if an error occurs.

 Example:
 // To retrieve the connection numbers where user JONI is logged in:
 iConnCount = UsrConLst("JONI")
 if ( iConnCount > 0 )
    for n = 1 to iConnCount
       iConnectNo = UsrConLst( "" )
       if ( iConnectNo != NOVERRINT )
          ? iConnectNo
       endif
    next
 endif

 Notes:
 The number of concurrent connections a user can have is controlled
 by the user's LOGIN_CONTROL property.

 After NOVERRINT is returned, check NWErrorGet().