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

 BLIFUNHAN()
------------------------------------------------------------------------------
 Purpose:
 Get a CA-Clipper DLL library function handle.

 Syntax:
 nuFunHandle = BLIFUNHAN(nuLibHandle,cFunName)

 Parameters:
 nuLibHandle  DLL library handle
 cFunName     Name of the required function

 Returns:
 A handle for the function or zero if the function does not exist in the DLL.

 Description:
 This function is used to obtain a handle for a CA-Clipper DLL function from
 the DLL library handle and the function name. This function handle is used
 to call the function, and 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.

 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.