OpenDBX/C API/odbx unbind

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

---

Back to Overview