[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 BLIFUNHAN()                   Get CA-Clipper DLL library function handle
------------------------------------------------------------------------------

 Function : Get a CA-Clipper DLL library function handle

 Syntax   : nuFunHandle = BLIFUNHAN(nuLibHandle,cFunName)

 Return   : A handle for the function or zero if the function does not exist

 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.

 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

See Also: BLIFUNCAL() BLILIBFRE() BLILIBLOD() BLILIBOVR()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson