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

dfFreeHnd()
Returns the number of available handles
------------------------------------------------------------------------------
Syntax:

     dfFreeHnd() --> nHandle

Parameters:

     NONE

Returns:

     <nHandle> Number of available handles in a program.

Description:

     Returns the maximum nuber of handles that can be used in a program. Do
     never allocate more file handles in a Clipper application than the
     number of handles DOS can manage. The number of file handles specified
     in CONFIG.SYS has precedence with respect to the number specified by
     Clipper. The following rule holds: the lower of the two numbers is
     used, and the minimum value is 20.
     
     . The first 5 DOS handles are:
     
     +---------------------------------+
     | # | Description      | Port     |
     |---+------------------+----------|
     | 0 | Standard input   | Keyboard |
     | 1 | Standard output  | Display  |
     | 2 | Standard error   | Display  |
     | 3 | Auxiliary device | COM1:    |
     | 4 | Printer output   | LPT1:    |
     +---------------------------------+

Example:

     // Launch the program using //F:100
     ? dfFreeHnd()  // Returns 95
     
     // Launch the program using //F:50
     ? dfFreeHnd()  // Returns 45

See also:

     dfMaxHnd()