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

See Also

Interop Object, Call.