HomePowerBuilderAppeon Documentation Center

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.

Default value

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

For an example, see the section called “OLE DB SQL functions” in Connecting to Your Database.

Prev  Up  Next
RPCRebind  Home  RTConnBalancing