Maptitude GISDK Help

LoadLibrary()

Summary

Loads a DLL and returns a handle that can be used in function calls.

 

Changes

Added in Version 6.0/2012.

 

Syntax

dllhandle = LoadLibrary(string dll_name [, array options])

 

Argument Contents
dll_name The name of the Dynamic Link Library (DLL)

 

Option Type Contents
StdCall Boolean If "true" assumes the _stdcall calling convention, where arguments are passed on the stack and the called function is responsible for removing them off the stack; default is "false"
FastCall Boolean If "true" assumes the _fastcall calling convention, where some arguments are passed in registers and the called function is responsible for popping other arguments off the stack; default is "false"
Cdecl Boolean Assumes the _cdecl calling convention, where the arguments are passed on the stack and the and the calling function is responsible for removing them off the stack; defaultis "true"
Return Type String Can be "double", "int" or "string"

 

Returns

A DLL handle.

 

Notes

Example

// You can use this to hook into Windows API.  Take for an example:

//

// int MessageBox(HWND hWnd, LPCTSTR lpText, LPCTSTR lpCaption, UINT uType)

//

// declared in user32.dll. You would actually call the MessageBoxA version with

 

hDll = LoadLibrary("user32.dll")

args = {{"long",0},{"char *","Hello World"},{"char *","My Title"},{"long",0}}

opts.StdCall = "True"

opts.[Return Type] = "long"

ret = hDll.MessageBoxA(args, opts)

 

Error Codes

Error Type Meaning
Error An invalid parameter was specified
NotFound The DLL or one of its required components was not found or could not be loaded

 

See Also

Function Summary
CallDllFunction() Calls a function in a Dynamic Link Library (DLL)
LaunchProgram() Starts a Windows program
LaunchDocument() Open a document, executable, or URL with the appropriate program

 

 

©2025 Caliper Corporation www.caliper.com