ReturnCommandHandle

Description

Specifies whether you want PowerBuilder to return a handle to a session object or a data source object when you call the DBHandle function.

Applies to

OLE DB

Syntax

ReturnCommandHandle =value

Parameter	Description
value	Specifies whether you want PowerBuilder to return a handle to a session object or a data source object. Values are: 0 (Default) Return a data source object pointer. 1 Return a session object pointer.

Parameter

Description

value

Specifies whether you want PowerBuilder to return a handle to a session object or a data source object. Values are:

0 (Default) Return a data source object pointer.

1 Return a session object pointer.

Default

ReturnCommandHandle=0

Usage

DBHandle takes a transaction object as a parameter and returns a long variable that is an interface pointer to a data source object or a session object. By default the OLE DB interface returns the handle of a data source object. If ReturnCommandHandle is set to 1, the OLE DB interface returns the handle of a session object. This handle can then be passed to an external program and instantiated for use in enlisting the connection in a Microsoft DTC (Distributed Transaction Coordinator) transaction.

Examples

Example 1

For an example, see “DBHandle, OLE DB example” in the online Help.