PC Toledo

LoadLibrary()

Loads an external DLL file into memory.
Syntax
LoadLibrary( <cDLLFile> ) --> nDllHandle

Arguments
<cDLLFile>
This is a character string holding the name of the 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 numeric DLL handle > 0. If the DLL file cannot be loaded, or does not exist, the return value is zero.
Description
The LoadLibrary() function loads a DLL file at runtime of an xHarbour application into memory that is not created with xHarbour. Functions residing in this DLL can then be invoked via DllCall() by passing the returned DLL handle.
If the DLL is already in use by other applications, LoadLibrary() does not load the DLL a second time, but increments the load counter of the DLL. This signals the operating system that the xHarbour application requires the DLL in addition to other applications.
When the DLL is no longer required, the DLL handle should be freed with FreeLibrary().
Note: function LibLoad() is available to load a DLL cerated with xHarbour.
Info