Description
Executes a Connection Object method; the Connection Object is specified by the passed handle.
Syntax
flag = XOMethod (hXO, method, arg1, arg2, arg3, arg4, arg5)
Parameters
The XOMethod function has the following parameters:
| Parameter | Description |
|---|---|
| HXO | Handle to the Connection Object. |
| Method | See methods below. |
| arg1...arg5 | Method specific; see methods below. |
| Method | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| XO_COMMITTRAN$ | commits the current transaction for the specified Connection Object. hXO [in] Connection Object handle (or 0 to get API-level errors like for XOCreate() which doesn't have an hXO). Error returned if commit fails. | ||||||||||||
| XO_DESTROY$ | releases a Connection Object handle; if the handle is shared, it decrements the reference count without actually closing the connection so that the sharing processes do not lose their connection. hXO [in] Connection Object handle Error returned for an invalid handle or if an error occurred destroying the Connection Object. | ||||||||||||
| XO_GETERROR$ | retrieves all pending Connection Object errors from the DS/XO API.
Error returned if no errors were pending. | ||||||||||||
| XO_ROLLBACKTRAN$ | rolls back the current transaction for the specified Connection Object. hXO [in] Connection Object handle. Error returned if rollback fails. | ||||||||||||
| XO_TRANSLATEFLAG$ | translates the bit-masked flag returned from the DS/XO API into TRUE$ for success and FALSE$ for failure; success includes both success and success with information (meaning possible pending messages) and failure includes an error (meaning possible pending messages), an invalid handle, and no more data.
|
Returns
TRUE$ for success or FALSE$ for failure.
