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