Dylibload

Home › Modularizing › DyLibLoad

DyLibLoad

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

Syntax

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

Parameters

• libname

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.

Return Value

The Pointer handle of the library loaded. Zero on error

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

Examples

See the dynamic loading example on the Shared Libraries page.

---

Category: Modularizing
Kind: function

---

Reproduced from the FreeBASIC Wiki Manual under the GNU Free Documentation License 1.3 — with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts. Copyright © the FreeBASIC project and wiki contributors. See License.