DyLibLoadfunction

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

Syntax

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

Parameters

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.

Remarks

Usage


result = DyLibLoad ( libname )


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
  
  

Example

See the dynamic loading example on the Shared Libraries page.

Reference

• Documented in KeyPgDylibload.html