qdb_parameters()

Updated: April 19, 2023

Get or set database connection parameters

Synopsis:

#include <qdb/qdb.h>

int qdb_parameters( qdb_hdl_t *db, int mask, int bits );

Arguments:

db
A pointer to the database handle.
mask
A bitmask representing the connection parameters you want to update. If you want to query the current connection parameters without modifying them, set this argument to 0.
bits
The bits corresponding to the parameters you want to enable. If a bit is in mask but not in bits, the parameter is unset (i.e., disabled).

Library:

qdb

Description:

This function queries or modifies the parameters for the specified database connection. You can set or unset the QDB_CONN_NONBLOCKING and QDB_CONN_STMT_ASYNC bits (see the flags argument for qdb_connect() for details about these settings). You can't change the QDB_CONN_DFLT_SHARE bit.

The function returns the previous bitmask (i.e., parameter settings), so the parameter settings can be temporarily changed and later restored.

Returns:

>=0
The previous value of the bitmask.
-1
An error occurred (errno is set).

Classification:

QNX Neutrino

Safety:  
Interrupt handler No
Signal handler No
Thread Yes