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