416
DLL( ) Function
Call Windows DLL
Formats
1. Load Library: lib_num=DLL(ADDR lib_string$[,ERR=stmtref])
2. Unload Library: DLL(DROP lib_num[,ERR=stmtref])
3. Get Function Address: fnc_addr=DLL(FIND lib_num,fnc_name$[,ERR=stmtref])
4. Call Using String: DLL(lib_string$,fnc_name$,arg[,arg,arg...][,ERR=stmtref])
5. Call by Library Number: DLL(lib_num,fnc_name$,arg[,arg,arg...][,ERR=stmtref])
6. Call Using Function Address: DLL(*,fnc_addr,arg[,arg,arg...][,ERR=stmtref])
Where:
arg, arg...
Parameters or arguments to pass to the function. The number and type
of arguments you use vary from function to function. See DLL( )
fnc_addr
Address of the desired function. Numeric expression.
Name of the function. The function name is the case-sensitive entry
fnc_name
point in the DLL. Some API functions have an appended letter A for
ASCII, others have an appended W for wide character UNICODE.
String expression.
lib_num
Internal library identifier used to reference a loaded library. Numeric
expression.
lib_string$ Name of the .dll or . exe that contains the function to be used. String
expression.
stmtref
Program line number or label to transfer control to.
Returns
Windows DLL (Dynamic Link Library), UNIX/Linux shared object module, or
address to a function within an external library.
Description
Use the ProvideX DLL( ) function to access functions within DLLs that are external to
ProvideX. This function is available under MS Windows as well as most
UNIX/Linux environments (in which case, TCB(196) returns 1 if the function is
supported). It's similar to a call to execute external functions from inside ProvideX
applications. The ProvideX DLL( ) function will also return any function identifiers
and addresses, as defined by the DLL routine.
DLLs do not need to be registered in Windows to be used in ProvideX. Under
WindX, it is important to note that DLLs run on the host. Use a call to a WindX
program to invoke a DLL.
Use the function DLX( ) to return 32-bit values from within a 16-bit Windows
environment. For further information on calling DLLs and other external
components from ProvideX, refer to the User's Guide, Chapter 9.