BLIFUNCAL()                   Call CA-Clipper DLL library function
------------------------------------------------------------------------------

 Function : Call a CA-Clipper DLL library function

 Syntax   : Result = BLIFUNCAL(param1,. . .,nuHandle)

 Return   : The result of the DLL library function

 This function is used to call a CA-Clipper function in a DLL which has been
 dynamically loaded at run time.

 Once a DLL has been dynamically loaded, the function BLIFUNHAN() is used to
 obtain a handle for the function from the DLL library handle and the
 function name. This function handle is valid until the DLL has been freed
 using BLILIBFRE().

 To call the DLL function, its parameters are passed to BLIFUNCAL() along
 with its function handle, which must be the last parameter, to BLIFUNCAL().
 The value returned by BLIFUNCAL() is the value returned by the DLL function
 which was called.

 Please see Chapter 5, 'DOS extended / Dual Mode programs', for more details
 on using DLLs.

 Example:

    libhan = BLILIBLOD (dllnme)      // Dynamically load the DLL
    if libhan > 32                // If it loaded successfully
       funhan = BLIFUNHAN (libhan,funnme)  // Get the handle
       if funhan > 0              // If the function was found
                      // Call function with (multiple) params
          funres = BLIFUNCAL (funpa1,funpa2,funhan)
                         // Note that function handle is LAST
       endif
       BLILIBFRE(libhan)          // Done so free the library
    endif