|
Interop::Call2
The Interop::Call2 function allows scripts to call
functions located in custom made external libraries and return a
string. It acts exactly like Call except that it expects a BSTR as
return value.
Syntax
[string] Call2(
[string] DllName,
[string] FunctionName,
[var, optional] Param1,
[var, optional] Param2,
[var, optional] Param3,
[var, optional] Param4,
[var, optional] Param5,
[var, optional] Param6,
[var, optional] Param7,
[var, optional] Param8,
[var, optional] Param9,
[var, optional] Param10,
[var, optional] Param11,
[var, optional] Param12
);
Parameters
- DllName
- [string] Path to the DLL file where the function to call
is located.
- FunctionName
- [string] Name of the function as specified in the export
table of the library.
- Param1
- [var, optional] First parameter to send to the function,
if any.
- Param2
- [var, optional] Second parameter to send to the function,
if any.
- Param3
- [var, optional] Third parameter to send to the function,
if any.
- Param4
- [var, optional] Fourth parameter to send to the function,
if any.
- Param5
- [var, optional] Fifth parameter to send to the function,
if any.
- Param6
- [var, optional] Sixth parameter to send to the function,
if any.
- Param7
- [var, optional] Seventh parameter to send to the function,
if any.
- Param8
- [var, optional] Eighth parameter to send to the function,
if any.
- Param9
- [var, optional] Ninth parameter to send to the function,
if any.
- Param10
- [var, optional] Tenth parameter to send to the function,
if any. Accepted only in Messenger Plus! Live 4.21 and above.
- Param11
- [var, optional] Eleventh parameter to send to the
function, if any. Accepted only in Messenger Plus! Live 4.21 and
above.
- Param12
- [var, optional] Twelfth parameter to send to the function,
if any. Accepted only in Messenger Plus! Live 4.21 and above.
Return Value
A BSTR string. This kind of string is constructed in a
particular way and must be created with a function such as
SysAllocString.
In addition to the reasons listed in Call, this function
may fail for the following reason:
- The returned value is not a pointer to a BSTR string.
Remarks
Because of its special nature, this function is generally only
useful for custom made DLL files distributed with the script. It
allows developers to easily design functions that return a string
to the script. For more information, check the documentation of
Call.
Function Information
| Object |
Interop |
| Availability |
Messenger Plus! Live 4.00 |
See Also
Interop Object, Call.
| 
