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

 BLIFUNCAL()
------------------------------------------------------------------------------
 Purpose:
 Call a CA-Clipper DLL library function.

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

 Parameters:
 param1. . . Function parameters.
 nuHandle    Function handle from BLIFUNHAN().

 Returns:
 The result of the DLL library function.

 Description:
 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.

 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                                                                       

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