Methoden von COM-Objekten werden normalerweise als Methoden von JS-Objekten aufgerufen. Dabei analysiert die Scriptengine die COM-Methoden-Parameter (durch TypeInfo) und die übergebenen JS-Variablen und nimmt die notwendige Konvertierungen vor.
Manchmal ist allerdings mehr Kontrolle notwendig (z. B. beim Debuggen).

Zu diesem Zweck findet das rc.com.native Objekt seine Verwendung. Es beinhaltet:

• Konstruktor Variant

• Konstruktor SafeArray

• Methode invoke

• Methode __dump

• Methode __ptr

• Konstanten VARENUM

• Konstanten INVOKE_FLAGS

rc.com.native.Variant

Code

• Es wird ein VARIANT mit gegebenem VT_xx(type) und valueerstellt.

• VT_BYREF ist ebenfalls erlaubt, in diesem Fall muss value ein rc.com.native.Variant sein.

• Aus value wird der VARIANT Inhalt konstruiert, s. Kapitel "Conversion"

• Der Inhalt von rc.com.native.Variant kann nachträglich nicht mehr geändert werden. Wenn es allerdings ein Ziel für VT_BYREF ist, kann die aufgerufene COM-Methode den Inhalt ändern.

• rc.com.native.Variant kann als Parameter bei COM-Methoden verwendet werden.

• rc.com.native.Variant hat die Eigenschaft $type und die Methoden getVartype, toJS,  __dbgOutput und __binOutput.

  • Methode getVartype(): gibt VT_xx Typ aus.

  • Methode toJS() : konvertiert rc.com.native.Variant in eine JS-Variable.

  • Um zu prüfen welchen Inhalt des Variants oxv8 konstruiert hat, gibt es folgende Methoden:

    • __dbgOutput :  erstellt Zusammenfassung vom VARIANT in einer lesbaren Form

    • __binOutput : gibt binären Inhalt vom VARIANT aus

Diese Code-Fragmente illustrieren die obigen Ausführungen. Nachfolgend gibt der Output des Codebeispiels die Wirkungsweise an:

Code

rc.com.native.SafeArray

Es wird ein SAFEARRAY mit bestimmten VT_xx Typ und Bounds erstellt, bei Bedarf mit mehr als einer Dimension.

Folgende Konstruktoren stehen zur Verfügung:

Code

type ist ein VT_xx Typ (ohne VT_ARRAY), VT_BYREF ist nicht erlaubt.

Mögliche Werte für bounds sind:

• [object,...] - ein Array mit Bound-Objekten (Dim ist dann die Anzahl von Objekten im Array)

• object – ein Bound-Objekt (in diesem Fall ist Dim=1)

• uint32 – Anzahl von Elementen bei einem Array mit Dim=1 und LBound=0

• null: Bounds werden aus values berechnet

Ein Bound-Objekt hat folgende Form (LBound ist optional, in diesem Fall wird 0 verwendet):

Falls values vorhanden ist, dann muss es ein JS-Array sein. Dabei muss auch Dim=1 sein. Elemente aus dem JS-Array werden nach VARIANT konvertiert (rc.com.native.Variant kann auch verwendet werden), und mit SafeArrayPutElement in das SAFEARRAY einzeln eingetragen (Index fängt dabei mit 0 an). Elemente im SafeArray können nachträglich mit putElement geändert werden.

Folgende Methoden stehen zur Verfügung:

• getVartype() : gibt VT_xx Typ des Array aus

• getDim() : gibt Anzahl der Dimensionen aus

• getElemsize() : gibt Größe des Elements in Bytes aus

• getUBound(dim) : gibt UpperBound pro Dimension aus (dim startet mit 1)

• getLBound(dim) : gibt LowerBound pro Dimension aus (dim startet mit 1)

• getElement([indices]) :  gibt ein Array-Element als rc.com.native.Variant aus

• putElement([indices],value) : setzt den Wert des entsprechenden Elements

• ptrOfIndex([indices]) : gibt den Wert des Pointers auf die Daten des Elements aus

• toJS() : konvertiert den Array in eine JS Variable

• __dbgOutput() : erstellt eine Zusammenfassung vom SAFEARRAY in einer lesbaren Form

• __binOutput() : gibt den binären Inhalt vom SAFEARRAY aus

indices – Array von Element-Indizes (bei Dim=1 ist es nur ein Index)

__dump(ptr,count)

Gibt binären Inhalt des Speichers aus. Diese Methode ist nur für Debugzwecke vorgesehen und kann sich in Zukunft ändern.

Parameter:

• ptr : Adresse, s. z. B. __ptr oder ptrOfIndex()

• count : Anzahl von Bytes

Rückgabewert: String mit Speicherinhalt

__ptr(object)

Ermittelt die Adresse des COM-Objekts. Diese Methode ist nur für Debugzwecke vorgesehen und kann sich in Zukunft ändern.

Parameter:

• object : JS-Object mit COM-Inhalt (IDispatch, IUnknown, IEnumVARIANT, VARIANT, SAFEARRAY)

Rückgabewert: String mit hexadezimaler Darstellung der Adresse vom dem COM-Inhalt. Falls object ein natives JS-Objekt ist, und nicht aus oxv8 kommt, wird null zurück geliefert.

Beispielcode zur Verwendung von __ptr und __dump mit nachfolgendem Output:

Code

invoke(obj,invokeParams)

invoke macht einen COM-Aufruf, siehe auch: https://docs.microsoft.com/en-us/windows/win32/api/oaidl/nf-oaidl-idispatch-invoke.

• obj : COM-Objekt, von dem die Methode aufgerufen wird

• invokeParams : notwendige Information, um IDispatch::Invoke Aufruf zu machen. invokeParams muss beinhalten:

  • memberID : memid der Methode aus TypeInfo

  • flags - rc.com.native.INVOKE_FLAGS Konstante

  • isPropertyPut: meistens false, (propput muss besonders behandelt werden, siehe https://docs.microsoft.com/en-us/windows/win32/api/oaidl/nf-oaidl-idispatch-invoke)

  • result - rc.com.native.Variant für den Rückgabewert

  • params: Array von rc.com.native.Variant

• Kein Rückgabewert

Code