qdb_gettransstate()

Return the transaction state for a QDB connection

Synopsis:

#include <qdb/qdb.h>

int qdb_gettransstate( qdb_hdl_t *db );

Arguments:

db: A pointer to the database handle.

Library:

qdb

Description:

This function returns the transaction state for the specified QDB connection. If an SQL transaction is in progress over the connection, the function returns 1. If no SQL transaction is happening, 0 is returned. If there's an SQL error, -1 is returned (you can use qdb_geterrmsg() to get the error string).

You can use this function to determine how to clean up after an SQL error; for example, if you execute several commands in a transaction and need to determine which statement is causing the error.

Returns:

1: An SQL transaction is in progress.
0: No SQL transaction is in progress.
-1: An SQL error occurred (errno is set).

Classification:

QNX Neutrino

Safety:
Interrupt handler	No
Signal handler	No
Thread	Yes