DyLibLoad

Loads to a Dynamic Link Library (DLL) into memory at runtime

Syntax
   Declare Function DyLibLoad ( ByRef libname As String ) As Any Pointer

Usage
   result = DyLibLoad ( libname )

Parameters
   libname
      A String containing the name of the library to load.

Return Value
   The Pointer handle of the library loaded. Zero on error

Description
   DyLibLoad is used to link at runtime libraries to your program. This 
   function does the link and returns a handle that must be used with 
   DyLibSymbol when calling a function in the library and with DyLibFree 
   when releasing the library.

   Note: If the libname string (without extension) already includes a 
   character dot (.), it may be mandatory to explicitly specify the 
   filename extension to avoid any parser ambiguity.

Example
   See the dynamic loading example on the Shared Libraries page.

Platform Differences
   * DOS: dynamic link libraries have ".dxe" file name extension and the 
     full libname must be specified: "<name>.dxe".
   * DOS: calling dylibload( "" ), using an empty file name will 
     initialize the run time library exports.
   * DOS: see specific Shared Libraries - DOS page

Dialect Differences
   * Not available in the -lang qb dialect unless referenced with the 
     alias __Dylibload.

Differences from QB
   * New to FreeBASIC

See also
   * DyLibSymbol
   * DyLibFree
   * Export

