Date: Fri, 29 Mar 2024 02:31:57 -0700 (PDT) Message-ID: <991953516.491.1711704717254@wiki.srpcs.com> Subject: Exported From Confluence MIME-Version: 1.0 Content-Type: multipart/related; boundary="----=_Part_490_837686404.1711704717254" ------=_Part_490_837686404.1711704717254 Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable Content-Location: file:///C:/exported.html
P= rovides COM support in any version of OpenInsight.
Result =3D SRP_Com= (Object, Service, Name, Param1, ..., Param16)
The meaning of the return value depends on the service.
Parameter | Description |
---|---|
Object | The target COM object. Required. |
Service | The action to take against the COM object. = Required. |
Name | Identifies the service's target, such as a prope= rty name. Optional. Some services require this p= arameter, others do not. See service topics for details. |
Param1 - Param16 | Optional parameters for COM methods and properti= es. |
The SRP_Com method was developed to meet a need for accessing COM compon= ents from within versions of OI that do not yet have that functionality bui= lt in.
Typical usage of COM requires objects to be instantiated, with a handle = to the object returned into an OI variable. This parameter requires a handl= e to an object in order call methods and properties. Note that some methods= and properties return new object handles, and those handles can be used to= "dig deeper" into the COM object hierarchy.
Much like the Utility function in OpenInsight, the SRP_Com function prov= ides multiple services which are identified in the Service parameter. The s= ervices are:
Service | Description |
---|---|
ADDPARAM | Adds a par= ameter to an advanced method call for a COM object. |
BEGINCALL | Begins an = advanced method call for a COM object. |
ENDCALL | Executes a= n advanced method call for a COM object. |
CREATE | Instantiates a COM object. |
RELEASE | Releases a previously instantiated COM object fr= om memory. |
GE= T | Gets a COM object's property value. |
SE= T | Sets a COM object's property value. |
C= ALL | Executes a COM object's method. |
= ERROR | Returns the latest COM error. |
HANDLES | Gets all open COM object handles. |
Click on the service names above to read more details. Continue below fo= r an explanation of the other parameters.
The Name parameter is used by the CREATE, GET, SET, and CALL services. F= or other services, it should be blank. For the CREATE service, Name is the = ProgId identifying the COM object to instantiate. For the GET and SET servi= ces, Name identifies a property. For the CALL service, Name identifies a me= thod.
COM properties and method often require additional parameters. SRP_Com s= upports up to 16 parameters to be passed. If you encounter a need for more,= contact SRP Computer Solutions, Inc. and we will be happy to accommodate y= ou.