Description: This function returns a value of a type specified by its parameter from a call to Microsoft Windows™ dynamic link library using the C calling convention.
Warning For use by advanced users only. Great care must be taken that all parameter values are correct when using this statement, since incorrect usage may cause a system crash.
Returns: varies (see table under ReturnType)
Usage: Script
Format: DLL(DLLName, FuncName, ReturnType, BuffLen, Type1, Val1, Type2, Val2, …)
Parameters:
DLLName {
text } { required } { no default
}
Any text expression
that gives the full path, file name, and extension of the DLL to load, or the
handle returned from a LoadDLL statement.
FuncName { text } { required } { no
default }
Any text
expression that gives the name of the function to call in the DLL.
ReturnType { numeric } { required } {
no default }
The
return type of the DLL function, as shown in the following table:
|
ReturnType |
Attribute |
|
0 |
Void (return value only) |
|
1 |
16 bit Integer |
|
2 |
32 bit Integer |
|
3 |
64 bit Double |
|
4 |
Pointer |
|
5 |
HWnd value of VTS Object |
BuffLen { numeric } { required } { no
default }
Any numeric
expression that gives the length of the returned buffer, if ReturnType is 4.
Type1, Val1, Type2, Val2, … { varies } {
required } { no default
}
Are any expressions
that determine the type of parameter passed to the DLL function, as shown in the
table for the ReturnType parameter. The
corresponding ValN parameter will be cast as
this type before it is passed to the DLL function.
Comments: This statement allows a wide variety of other routines and code to be used in an application.
Note: 64-bit VTS can load only 64-bit DLLs. 32-bit VTS can load only 32-bit DLLs.
VTS Internet Clients can load only 32-bit DLLs regardless of whether the VTS server is 32-bit or 64-bit.
See Also: