OLETxnObject object

The OLETxnObject object provides explicit control of MTS transactions to PowerBuilder clients using the SetComplete and SetAbort functions. OLETxnObject inherits from the OLEObject object.

Properties

OLETxnObject property

Datatype

Description

ClassDefinition

PowerObject

An object of type PowerObject containing information about the class definition of the object or control

Handle

Objhandle

Internal use only


Events

OLETxnObject event

Occurs

Constructor in PowerScript Reference

When the object is created.

Destructor in PowerScript Reference

When the object is destroyed.

Error in PowerScript Reference

When an error is found in a data or property expression for an external object.

ExternalException in PowerScript Reference

When the evaluation of an expression involving properties of an external object causes an error. This type of event occurs before the Error event.


Functions

OLETxnObject function

Datatype returned

Description

ClassName in PowerScript Reference

String

Returns the name assigned to the user object.

ConnectToNewObject in PowerScript Reference

Integer

Creates a new instance of the class within the transaction context it is associated with and connects to it.

ConnectToNewRemoteObject in PowerScript Reference 

Integer

Not used.

ConnectToObject in PowerScript Reference

Integer

Not used.

ConnectToRemoteObject in PowerScript Reference

Integer

Not used.

DisconnectObject in PowerScript Reference

Integer

Releases all objects previously connected.

GetAutomationNativePointer in PowerScript Reference

Integer

Returns a pointer to the underlying OLE object.

GetContextService in PowerScript Reference

Integer

Creates a reference to a context-specific instance of the specified service.

GetParent in PowerScript Reference

PowerObject

Returns a reference to the name of the parent object.

IsAlive in PowerScript Reference

Boolean

Determines whether a server object is defunct.

PostEvent in PowerScript Reference

Boolean

Adds an event to the end of the message queue of the user object.

ReleaseAutomationNativePointer in PowerScript Reference

Integer

Releases the pointer to the underlying OLE object.

SetAbort in PowerScript Reference

Integer

Aborts the current transaction.

SetAutomationLocale in PowerScript Reference

Integer

Sets the language locale to be used for automation programming on the object.

SetAutomationPointer in PowerScript Reference

Integer

Sets the automation pointer of the OLETxnObject object to the value of the automation pointer of another object.

SetAutomationTimeout in PowerScript Reference

Integer

Sets the number of milliseconds that a PowerBuilder client waits before canceling an OLE procedure call to the server.

SetComplete in PowerScript Reference

Integer

Attempts to commit the current transaction.

TriggerEvent in PowerScript Reference

Integer

Sends an event to the user object and executes the script associated with the event.

TypeOf in PowerScript Reference

Object

Returns the type of the user object.