Added in 1.9.4
$com(name|N)
Returns name if connection is open, or name of Nth connection. N = 0 returns number of open connections.
Parameters
| Parameter | Description |
| name|N | The connection name or the Nth connection. |
Properties
| Property | Description |
| .progid | The object name. |
| .result | The value returned by the COM object member after the call |
| .error | The error code if any. |
| .errortext | The error text if any. |
| .argerr | TODO |
| .dispatch | $true if this is a dispatch pointer. |
| .unknown | $true if this is a unknown pointer. |
$com(name, &bvar)
Returns connection information for the connection and puts it into &bvar.
Parameters
| Parameter | Description |
| name| | The connection name. |
| &bvar | The &bvar to write to. |
Properties
| Property | Description |
| .progid | The object name. |
| .result | The value returned by the COM object member after the call |
| .error | The error code if any. |
| .errortext | The error text if any. |
| .argerr | TODO |
| .dispatch | $true if this is a dispatch pointer. |
| .unknown | $true if this is a unknown pointer. |
$com(name/N,varname)
Returns value of the specified variable name.
Parameters
| Parameter | Description |
| name/N | The connection name or the Nth connection. |
| varname | Name of the referenced variable. |
$com(name,member,method,type1,value1,...,typeN,valueN)
This calls a member of an open COM connection with the specified method and parameters.
Returns: 1 = ok, 0 = fail.
Parameters
| Parameter | Description |
| name | Connection name. |
| alias | Alias to call when the call is finished. |
| member | Member name. |
| method | Combination of the method values added together (see below). |
| type | The variable type (see below), |
| value | The value assigned to the variable type. |
Methods
| Method | Description |
| 1 | DISPATCH_METHOD |
| 2 | DISPATCH_PROPERTYGET |
| 4 | DISPATCH_PROPERTYPUT |
| 8 | DISPATCH_PROPERTYPUTREF |
Types
Can be: i1, i2, i4, ui1, ui2, ui4, int, uint, r4, r8, cy, date, decimal, bool, bstr, variant, dispatch, unknown, error.
VB equivalents are: boolean, byte, currency, date, double, integer, long, single, string, variant.
To make a variable by reference, use * in the type name, eg. i1*
To assign a name to a variable for later reference after a call, append it to the type, eg. i1* varname
When using a variant you must also specify the variable type after it, eg. variant bool.
Updated by Per Amundsen over 1 year ago · 7 revisions