OpenDBX/C API/odbx unbind

#include <odbx.h>

int odbx_unbind(
    odbx_t* handle ) 

Description:

Releases the binding to the database and user for the connection opened by odbx_bind_simple(). This is useful for switching to another database or binding to the database as a different user. It is also possible to set new connection related options before rebinding to the database server.

This function must be invoked before calling odbx_finish() to avoid memory leaks.

Parameters:

• handle: Connection object created by odbx_init()

Return values:

• ODBX_ERR_SUCCESS on success
• Less than zero if an error occured

Errors:

• -ODBX_ERR_PARAM: "handle" is NULL or the structure is invalid

See also:

• OpenDBX_bind
• OpenDBX_error
• OpenDBX_error_type
• OpenDBX_finish

---

Back to Overview