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

When the object is created.

Destructor

When the object is destroyed.

Error

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

ExternalException

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

String

Returns the name assigned to the user object.

ConnectToNewObject

Integer

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

ConnectToNewRemoteObject 

Integer

Not used.

ConnectToObject

Integer

Not used.

ConnectToRemoteObject

Integer

Not used.

DisconnectObject

Integer

Releases all objects previously connected.

GetAutomationNativePointer

Integer

Returns a pointer to the underlying OLE object.

GetContextService

Integer

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

GetParent

PowerObject

Returns a reference to the name of the parent object.

IsAlive

Boolean

Determines whether a server object is defunct.

PostEvent

Boolean

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

ReleaseAutomationNativePointer

Integer

Releases the pointer to the underlying OLE object.

SetAbort

Integer

Aborts the current transaction.

SetAutomationLocale

Integer

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

SetAutomationPointer

Integer

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

SetAutomationTimeout

Integer

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

SetComplete

Integer

Attempts to commit the current transaction.

TriggerEvent

Integer

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

TypeOf

Object

Returns the type of the user object.