BLILIBLOD()                   Dynamically load CA-Clipper DLL library
------------------------------------------------------------------------------

 Function : Dynamically load a CA-Clipper DLL library

 Syntax   : nuHandle = BLILIBLOD(cLibName)

 Return   : A handle representing the DLL, or an error code less than 32 if
            the load failed

 This function is used to dynamically load a CA-Clipper DLL during program
 execution. This allows programs to be extended or updated 'on the fly'
 without relinking the main .EXE.

 The library handle is used to obtain handles for the functions in the DLL
 which are then used to call the functions.

 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
    endif