ConnectToNewObject
PowerScript function
Description
Creates a new object in the specified server application and
associates it with a PowerBuilder OLEObject variable. ConnectToNewObject
starts the server application if necessary.
Applies to
OLEObject objects, OLETxnObject objects
Syntax
|
1 |
oleobject.ConnectToNewObject ( classname ) |
|
Argument |
Description |
|---|---|
|
oleobject |
The name of an OLEObject variable that you want to connect |
|
classname |
A string whose value is a programmatic identifier or class |
Return value
Integer.
Returns 0 if it succeeds and one of the following negative values if
an error occurs:
-1 — Invalid Call: the argument is the Object property of a
control
-2 — Class name not found
-3 — Object could not be created
-4 — Could not connect to object
-9 — Other error
-15 — COM+ is not loaded on this computer
-16 — Invalid Call: this function not applicable
If any argument’s value is null, ConnectToNewObject returns
null.
Usage
The OLEObject variable can be used for automation, in which the
PowerBuilder application asks the server application to manipulate the OLE
object programmatically. It can also be used to connect to a COM object
that is registered on a local or remote computer or that is installed in
COM+.
The OLETxnObject variable is used to provide COM+ transaction
control to PowerBuilder clients. Calling ConnectToNewObject with an
OLETxnObject variable creates a new object instance within the transaction
context associated with the variable. If COM+ is not loaded on the client
computer, the ConnectToNewObject call fails. Use SetAbort to abort the
transaction or SetComplete to complete it if all other participants in the
transaction concur.
For more information about automation and connecting to COM objects,
see ConnectToObject.
Deprecated support for COM and COM+ components
COM and COM+ are obsolete technologies and might not be supported
in future releases of PowerBuilder.
Examples
This example creates an OLEObject variable and calls
ConnectToNewObject to create a new Excel object and connect to it:
|
1 2 3 4 5 |
integer result OLEObject myoleobject myoleobject = CREATE OLEObject result = myoleobject.ConnectToNewObject( & "excel.application") |
This example creates an OLETxnObject variable and calls
ConnectToNewObject to create and connect to a new instance of a
PowerBuilder COM object on a COM+ server:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
OLETxnObject EmpObj Integer li_rc EmpObj = CREATE OLETxnObject li_rc = EmpObj.ConnectToNewObject("PB125COM.employee") IF li_rc < 0 THEN DESTROY EmpObj MessageBox("Connecting to COM Object Failed", & "Error: " + String(li_rc)) Return END IF // Perform some work with the COM object ... // If the work completed successfully, commit // the transaction and disconnect the object EmpObj.SetComplete() EmpObj.DisconnectObject() |
See also