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

 FilOpnFilLst()
------------------------------------------------------------------------------
 Purpose:
 Get list of open files for a connection.

 Syntax:
 lpszFileName = FilOpnFilLst( iConNum, iIndex )

 Parameters:
 iConNum The connection number for which to return a list of open files.
 iIndex  The index into the list of open files.

 Returns:
 A character string of length 255.

 Description:
 FilOpnFilLst() is used to obtain a list of files that a specific
 workstation has open.

 FilOpnFilLst() is called with the first parameter iConNum set to the
 connection number of the workstation of interest and the index number
 iIndex set initially to 1, then incremented with each subsequent call until
 an empty (null) string is returned.

 If FilOpnFilLst() returns an empty character string and NWErrorGet()
 returns 255, the workstation has no files open, or the end of the list has
 been reached.

 Example:
 // This example shows how FilOpnFilLst() can be used to
 // return a list of files that connection 4 has open:

 iCounter = 1
 lpszFileSpec = FilOpnFilLst( 4, iCounter )
 ? "Connection number 4 has the following files open:"
 do while !empty( lpszFileSpec )
    ? lpszFileSpec
    lpszFileSpec = FilOpnFilLst( 4, ++iCounter )
 enddo

 Notes:
 This function requires that the requesting user has console
 operator rights.