DyLibLoad

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

Syntax
	KeyPgDeclareDeclare KeyPgFunctionFunction DyLibLoad ( KeyPgByrefByRef libname KeyPgAsAs KeyPgStringString ) KeyPgAsAs KeyPgAnyAny KeyPgPtrPointer

Usage
	result = DyLibLoad ( libname )

Parameters
	libname
		A KeyPgStringString containing the name of the library to load.

Return Value
	The KeyPgPtrPointer handle of the library loaded. Zero on error

Description
	KeyPgDylibload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 
	KeyPgDylibsymbolDyLibSymbol when calling a function in the library and with KeyPgDylibfree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 ProPgSharedLibraries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 ProPgSharedLibrariesDOSShared Libraries - DOS page

Dialect Differences
	* Not available in the CompilerOptlang-lang qb dialect unless referenced with the 
	  alias __Dylibload.

Differences from QB
	* New to FreeBASIC

See also
	* KeyPgDylibsymbolDyLibSymbol
	* KeyPgDylibfreeDyLibFree
	* KeyPgExportExport

