xHarbour Reference Documentation > Function Reference

LibLoad()

Loads an xHarbour DLL file into memory.

Syntax

LibLoad( <cDllFile> ) --> pDLL

Arguments

<cDLLFile>

This is a character string holding the name of the xHarbour DLL file to load into memory. It must contain complete path information, unless the file is located in the current directory, or in the list of directories held in the SET PATH environment variable of the operating system.

Return

The function returns a pointer to the DLL file. If the DLL file cannot be loaded, or does not exist, the return value is a null pointer.

Description

The LibLoad() function loads a DLL file created by xHarbour at runtime of an application into memory. All symbolic names of the functions residing in the DLL are added to the symbol table of the application. These functions can then be invoked via HB_LibDo() or by using the macro operator. Refer to function HB_LibDo() for an extensive example on the possibilities of invoking functions within a dynamically loaded DLL.

Note:  function LoadLibrary() is available to load DLLs at runtime which are not created by xHarbour.

Info

See also:	HB_LibDo(), LibFree(), LoadLibrary()
Category:	DLL functions , xHarbour extensions
Source:	vm\dynlibhb.c
LIB:	xhb.lib
DLL:	xhbdll.dll